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1  INTRODUCTION:  NETWORK  OPERATIONS  AND  MAINTENANCE 
(NOM)  CSCI  DESCRIPTION 


1.1  Background 

Network  Operations  and  Maintenance  G^OM)  CSCI  is  a  system  used  to  centralize  the  on¬ 
line  management  of  SIMNET  sites,  with  emphasis  on  providing  tools  for  SIMNET  site 
technicians  to  manage  simulators.  Technicians  typically  use  NOM,  rather  than  MCC 
(Management  Command  and  Control),  to  activate  simulators  for  inspection,  maintenance, 
and  troubleshooting.  Features  of  NOM  include  simulator  control,  simulator  status  displays, 
and  site  monitoring. 

Simulator  control  includes  commands  and  windows  that  allow  a  technician  to  control 
individual  simulators,  groups  of  them,  or  all  the  simulators  at  a  site  ftxjm  a  single  console. 
These  controls  allow  different  levels  of  a  simulator  to  be  activated  or  deactivated.  A 
technician  can  issue  commands  to  do  the  following  activities: 

•  powerup  or  powerdown  a  simulator; 

•  shut  down  a  simulator  -  which  stops  the  UNIX  operating  system  but  does  not 
turn  off  power;  start  or  stop  a  simulation  process;  and, 

•  activate  or  deactivate  a  simulator  into  or  from  an  exercise. 

Simulator  status  displays  include  commands  and  windows  that  allow  a  technician  to  display 
simulator  equipment  status  and  exercise  status  on  demand,  and  to  display  outstanding 
simulator  events  automatically.  Outstanding  events  are  those  events  ^at  are  pending  an 
acknowledgement  by  the  user  interface.  Event  reports  are  propagated  from  event  messages 
sent  by  a  simulator,  or  from  unexplained  events,  such  as  the  dropout  or  startup  of  a 
simulator,  or  an  equipment  warning  or  clearing  of  a  warning.  There  are  also  unexplained 
events  which  involve  a  state  change  without  an  accompanying  request  from  NOM  or  MCC. 

In  site  monitoring,  NOM  monitors  simulator  power  via  a  power  controller  interface.  NOM 
monitors  equipment  status  and  error  packets  via  a  SIMNET  network  interface,  which  NOM 
logs  into  an  events  log.  In  addition,  NOM  contains  functions  that  determine  which  events 
should  be  sent  immediately  to  the  user  interface.  Such  events  signify  a  simulator  state 
change,  and  will  cause  a  color-coded  alarm  display. 

NOM  communications  processes  enable  a  technician  to  use  the  NOM  console  as  if  the 
technician  were  logging  on  and  interacting  with  a  SIM  host  terminal.  This  remote  terminal 
emulation  capability  brings  up  a  remote  SIM  window,  making  it  possible  for  the  technician 
to  enter  commands  without  having  to  walk  to  each  simulator.  A  technician  at  a  NOM 
console  can  also  see  command  lines  being  entered  by  another  technician  at  the  local  console 
of  a  simulator,  and  vice-versa.  Another  NOM  communications  feature  allows  a  technician 
to  view  simulator  output  at  a  NOM  console  while  the  simulator  is  running. 
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1.2  External  Interfaces 

NOM  interfaces  with  the  following  SIMNET  Systems: 

•  Simulator  (SIM)  hosts; 

•  Management  Command  and  Control  (MCC);  and, 

•  Power  Controller 

NOM  external  interfaces  are  illustrated  in  Figure  1.2-1,  "NOM  External  Interfaces,"  and 
summarized  in  Table  1.2-1,  "Summary  of  NOM  External  Interfaces." 


Figure  1.2-1:  NOM  External  Interfaces. 

NOM  communicates  with  SIM  hosts  and  MCC  systems  over  Ethernet,  and  with  the  Power 
Controller  using  a  serial  RS-232  line.  SIMNET  simulation,  management,  data  collection, 
and  special  NOM  communications  subsystem  protocols  are  used  for  the  Ethernet 
communications.  A  SIMNET  serial  protocol  is  used  for  the  RS-232  connection.  Table 
1 .2- 1  summarizes  the  NOM  External  Interfaces. 
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Interface  ID 

From 

To 

Description 

Protocol 

NOM_EXT_IF1 

SIM  host 

NOM 

equipment  status 

Data 

Collection 

NOM  EXT  IF1 

SIM  host 

NOM 

Error  Reports 

Manaqement 

NOM  EXT  IF1 

SIM  Host 

NOM 

'Heartbeat'  PDU 

Monitor 

NOM  EXT  IF1 

SIM  host 

NOM 

User  input  from  SIM  console 

Monitor 

NOM  EXT  IF1 

SIM  host 

NOM 

Command  output 

Monitor 

NOM  EXT  IF1 

NOM 

Create  UNIX  shell 

Monitor 

NOM  EXT  IF1 

SIM  host 

NOM 

NSCP  Process  Response 

Monitor 

NOM  EXT  IF2 

NOM 

SIM  host 

Shell  output 

Monitor 

NOM  EXT  IF2 

NOM 

SIM  host 

Transfer  Reliability  (?) 

Monitor 

NOM  EXT  IF2 

NOM 

SIM  host 

User  input  from  NOM  console 

Monitor 

NOM_EXT_IF2 

NOM 

SIM  host 

Request  to  Create  Remote 

SIM  UNIX  shell 

Monitor 

NOM  EXT  IF2 

NOM 

NSCP  Process  Request 

NSCP 

NOM  EXT  IF2 

NOM 

SIM  Host 

Poll  Sim  "Heartbeat" 

Monitor. 

NOM  EXT  IF2 

NOM 

SIM  host 

Request  Error  Reports 

Monitor 

NOM_EXT_IF3 

Power 

Controller 

NOM 

Power  Status 

Serial 

NOM_EXT_IF4 

NOM 

Power 

Controller 

Power-related  Commands 

Serial 

NOM  EXT  IF5 

MCC 

NOM 

Error  reports 

Manaqement 

Table  1.2-1:  Summary  of  NOM  External  Interfaces 
(refer  to  Figure  1.2-1,  "NOM  External  Interfaces"). 


Note:  TF'=’interface';  'NSCF=New  SIMNET  Copy  Protocol. 


For  information  on  Data  Collection  and  Management  protocols,  refer  to  "SIMNET 
Network  and  Protocols,"  Chapters  7  and  8. 

For  information  on  SIMNET  protocol  data  units,  refer  to  "BBN  Report  No.7102-The 
SIMNET  Network  and  Protocols." 


1.3  Internal  Structure 

NOM  is  configured  as  a  NOM  host  running  NOM  application  software,  and  a 
communications  application  distributed  between  a  set  of  processes  on  the  NOM  host,  and  a 
set  of  processes  on  each  of  the  SIMNET  simulator  hosts.  The  distributed  application 
allows  a  technician  to  manage  simulators  remotely,  from  a  central  location,  or,  to  control  a 
single  simulator  from  its  locally  attached  SIM  host  console.  NOM  is  modular  in  that  it  can 
be  run  with  less  than  full  functionality  at  a  site  that  does  not  have  the  full  range  of 
hardware. 
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NOM  functionality  may  be  broken  down  into  these  top-level  CSCs. 

•  Graphical  user  interface  (GUI); 

•  Management  applications  process  (MAP); 

•  Interface  to  power  controller  (Lamplighter  Interface); 

•  NOM  communications; 

•  NOM-level  processing. 

The  breakdown  into  top-level  CSCs  is  illustrated  in  Figure  1.3-1,  "NOM  CSCI  Structure." 
Further  decomposition  of  top-level  CSCs  into  lower-level  CSCs  and  CSUs  is  described  in 
Section  2. 

These  CSCs  are  implemented  relatively  independently  within  NOM  as  separate 
subsystems.  Interfaces  with  one  another  are  illustrate  in  Figure  1.3-1,  "NOM  Internal 
Interfaces,"  and  summarized  in  Table  1.3-1,  "Summary  of  NOM  Internal  Interfaces." 
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IF=lnterface 


U 


Ethernet 

Figure  1.3-1:  NOM  Internal  Interfaces. 
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Interface  ID 

From 

To 

Description 

Protocol 

NOM  INT  IF.1 

GUI 

MAP 

User  commands 

Man.-Man. 

NOMJNTJF.1 

Gm 

MAP 

Status  Queries,  including  non- 
important  events 

Shared  mem. 

NOM  INT  IF.2 

MAP 

GJ 

Response  to  user  commands 

Man.-Man 

MAP 

GUI 

Important  events-see  dwilbert 

Man.-Man. 

NOM  INT  1F.3 

Comm.. 

MAP 

SIM  "Heartbear 

Monitor. 

NOM  INT  IF.3 

Comm. 

MAP 

SIM  Error  Reports 

Monitor. 

NOM  INT  IF.4 

MAP 

Comm. 

Sim  and  UNIX-ike  Commands 

Monitor. 

NOM  INT  IF.4 

MAP 

Comm 

Request  Error  Reports 

Monitor 

NOM  INT  IF.5 

MAP 

LL  Interface 

Power  Requests 

Man.-Man. 

NOM  INT  IF.6 

LL  Interface 

MAP 

Power  status 

Shared  Mem. 

NOM  INT  IF.7 

GUI 

Comm. 

Request  for  SIM  UNIX  shell 

NOM  INT  IF.8 

Comm. 

GUI 

Response  to  SIM  UNIX  shell 
request 

Monitor 

Table  1.3-1:  Summary  of  NOM  Internal  Interfaces 
(refer  to  Figure  1.3-1,  "NOM  Internal  Interfaces"). 


There  are  two  kinds  of  communications  used  between  NOM  CSCs. 

One  kind  of  communication  is  based  on  shared  memory  which  contains  information 
maintained  by,  and  accessible  to,  each  subsystem.  This  more  passive  mechanism  of  inter¬ 
process  communication  allows  other  subsystems  to  access  the  information  and  act  upon  it 
at  later  times. 

The  NOM  shared  memory  provides  a  common  set  of  information  which  is  accessed  by  all 
the  subsystems  of  the  NOM.  All  the  NOM  shared  memory  is  contained  in  a  structure  called 
Nominfo.  Each  subsystem  is  responsible  for  entering  its  own  name.  Nominfo  also 
contains  the  current  threshold  values  for  those  equipment  status  values  that  will  generate 
alarms.  Also  included  are  a  few  configuration  parameters  and  a  table  which  contains 
attributes  about  all  the  simulators. 

The  other  kind  of  communication  is  message  based,  in  which  one  process  sends  a  message 
to  another  process  (in  a  different  CSC),  which  then  proceeds  to  act  on  the  message.  This 
kind  of  communication  is  very  active  in  nature;  sending  a  message  generally  prompts  a 
response.  Messages  in  NOM  are  generally  used  to  request  a  service  of  another  subsystem 
or  to  alert  a  subsystem  to  an  important  event. 

NOM  CSCs  communicate  using  IPC  (Inter-Process  Communications)  services  to  set  up  an 
I/O  interface.  Data  passed  is  structured  according  to  Manager- Manager  protocols  or  special 
NOM  Communications  protocols.  CSCs  share  information  in  NOM  shared  memory  for 
events  that  do  not  require  immediate  servicing.  CSCs  use  special  Communications  IPC 
and  data  protocol  when  using  Communications  services. 
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Management  protocol  governs  communications  between  GUI,  MAP,  and  the  Lamplighter 
interface.  It  defines  the  following  PDUs  (Protocol  Data  Unit); 

•  Event; 

•  Action  request; 

•  Action  response 

The  NOM  communications  CSC  uses  a  protocol  called  the  "monitor"  protocol  to  control 
communications  within  the  communications  CSC  itself,  between  this  CSC  and  other  NOM 
CSC,  and  between  this  CSC  and  SIM  hosts.  The  GUI  uses  this  protocol  to  open  or  close  a 
session  with  a  remote  SIM  software  shell,  and  MAP  uses  this  protocol  to  send  commands 
to  a  SIM. 

Protocol  Data  Units  used  for  intra-NOM  communication  are  summarized  in  Table 
1.3-2,  below. 


PDU 

CSCI/CSC 

From 

CSCI/CSC 

To 

Synchron¬ 

ization 

Protocol 

Contents 

command 

MessageKind 

rsend 

fido 

contingent 

upon 

AttachMes- 

saoe 

Local  IPC 

Execute 
command 
remote  system. 

command 

MessageKind 

mon_rcmd 

rover 

contingent 

upon 

AttachMes- 

saoe 

Local  IPC 

Execute 
command  on 
renfX)te  system. 

attach 

MessageKind 

mon_wind 

fido 

asynchronous 

Local  IPC 

Open 

connection  to 
fido. 

attach 

messageKind 

tee- In; 
monjemd 

rover 

asynchronous 

Local  IPC 

Open 

connection  to 
rover. 

writeMessage 

Kind 

rsend  (MAP) 

fido  (NOM 
Comms.) 

contingent 

upon 

AttachMes- 

saae 

Local  IPC 

Write  text  to 
remote  shell. 

listRequest 

MessageKind 

rover 

tee-in; 

rrronjmcd 

contingent 

upon 

AttachMes- 

saae 

Local  IPC 

killMessage 

Kind 

mon_wind; 

mon_rcmd 

fido 

contingent 

upon 

AtlachMes- 

saqe 

Local  IPC 

Shut-down  local 
connection 

killMessage 

Kind 

tee-in; 

monJemd; 

mon_rcmd 

rover 

contingent 

upon 

AttachMes- 

saoe 

Local  IPC 

shut-down  local 
connection 

(Table  1.3-2  is  continued  on  the  following  page.) 
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PDU 

CSCI/CSC 

From 

CSCI/CSC 

To 

Synchron¬ 

ization 

Protocol 

Contents 

monitorQuery 

PDUKind 

(ido 

either  fido  or 
rover 

periodic 

Monitor 

Opening  a 
connection; 
used  in  polling 
SIMs  and  other 
NOMs;  sent 
before  sending 
text  or  command 
PDUs. 

monitorQuery 

PDUKind 

rover 

either  fido  or 
rover 

Monitor 

Opening  a 
connection; 
sent  before 
sending  a 
remote 
command  or 
text. 

monitorRe- 

sponsePDU 

Kind 

either  fido  or 
rover 

either  fido  or 
rover 

Sent  upon 
receiving 
monitorQuery 
PDU. 

Monitor 

Monitor  process 
responds  by 
identifying  itself; 
lack  of,  or  wrong, 
response  closes 
connection. 

shellOpen 

PDUKind 

fido 

rover 

Contingent 

upon 

receiving 

MonitorRe- 

SDonsePDU. 

Monitor 

Request  to 
open  a  remote 
session 

remoteCom- 

mandPDU 

Kind 

(See  Note  1). 

fido: 

rover 

rover; 

fido 

Contingent 

upon 

MonitorRe- 
sponsePDU; 
responds  to 
receiving  local 
IPC  PDU. 
command- 
Messaoe. 

Monitor 

Command  text 

shellStatus 

PDUKind 

rover 

fido 

Looks  for 

EOF  at  end  of 
pseudo-tty,  as 
welt  as  other 
checking; 
returned  in 
response  to 
ShellOpen 
PDU. 

Monitor 

Session  Status 

shellText 

PDUKind 

fido 

rover 

Contingent 
upon 
receiving 
shellStatus 
PDU.  In 
response  to 
local  IPC  PDU 
writeMessage 

Monitor 

Text  for  a  shell. 

(Table  1.3-2  is  continued  on  the  following  page  ) 
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PDU 

CSCI/CSC 

From 

CSCI/CSC 

To 

Synchron¬ 

ization 

Protocol 

Contents 

shellText 

PDUKind 

rover 

fido 

Retransmitted 
unacknowled 
ged  text  up  to 

3  times. 

Monitor 

Text  from  a  shell. 

shellAckPDU 

Kind 

(See  Note  2) 

fido 

rover 

Sent  upon 

receiving 

shellTextPDU 

Monitor 

Acknowledge 

ShellTextPDU. 

Event 

MAP 

GU 

Immediately 
sent  upon 
failure  of 
requested 
action; 
immediately 
sent  when 

SIM  state 
changes  to 
alarmed  state. 

Manager- 

Manager 

Action  request 
failure;  SIM 
alarmed  state 
change. 

Event 

LL-Interface 

MAP 

Immediately 

sent  uDon 
detection  of 
F>ower 
anomaly 

Manager- 

Manager 

Power  anomaly 

Action 

Request 

GU 

MAP 

Asynchro¬ 

nous 

Manager- 

Manaqer 

Requests  an 
Operation 

Action 
Response 
(See  Note  3) 

MAP 

GUI 

acknowledge¬ 
ment  of 
Request.with 
matching 
action  ID. 

Manager- 

Manager 

Request  for 
action  has  been 
received:  action 
ID  same  as 
requested 
action  ID. 

Table  1.3-2:  Summary  of  NOM  Protocol  Data  Units  (PDUs) 


SIMNET  management,  data  collection,  and  simulation  protocols  are  described  in  "SIMNET 
Network  and  Protocols'"  BBN  Report  No.  1702. 

Some  abbreviations: 

'YUMM'  -  names  a  BBN  library  that  contains  monitor  IPC  functions. 

'Pseudo-tty'  -  a  pseudo  I/O  device.  A  pseudo  tty  is  treated  as  a  device  for  purposes  of 
identifying  input  and  allocating  storage. 

'Fido'  and  'Rover'  are  CSUs  described  in  Section  2.4. 1.1  and  Section  2.4.2. 1, 
respectively.  In  accordance  with  modularity  constraints  (Section  2)  they  interface 
indirectly,  through  their  parent  CSC  nodes,  NOM  Host  Communications  Processes 
(Section  2.4.1)  and  SIM  Host  Comms  Processes  (Section  2.4.2). 
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Notes: 

1 .  Rover  does  not  acknowledge  messages  from  Fido. 

2.  Fido  acknowledges  messages  from  Rover.  Text  messages  have  forced  s^uence 
numbering.  Character  sequence  numbers  are  used  to  represent  positions  in  the  text 
stream  for  the  purpose  of  acknowledgement.  If  SIM  fads  to  receive  an 
acknowledgement  for  text  it  has  sent,  it  will  retry  the  transmission  up  to  three  times. 

3 .  If  the  action  can  be  performed  immediately,  the  MAP  does  so  and  returns  an 
actSuccess  or  actFailure  return  code.  If  the  request  will  take  some  time,  the  MAP 
returns  a  response  with  an  actAcknowledge  return  code. 

4 .  Monitor  PDUs  are  placed  in  Ethernet  packets  with  IEEE  802.3  headers. 

Monitor  protocol  parameter  settings: 

Number  of  characters  by  which  Rover's  transmissions  to  Fido  are  permitted  to  "get  ahead" 
of  acknowledgements  received  back  from  Fido=transmitTextBufferLength,  500 
characters. 

Amount  of  time  that  Rover  will  wait  for  an  acknowledgement  before  retransmitting  text  to 
Fido  =  monitorRetryTimeout,  3  seconds. 

Number  of  times  Rover  will  transmit  a  particular  block  of  characters  to  Fido,  seeking  an 
acknowledgement  each  time  =  maxTextTransmitAttempts,  3. 

Interval  with  which  Fido  polls  for  any  Rover  processes  on  the  network  = 
simulatorPollInterval,  30  seconds. 

Interval  after  which  Fido  declares  a  silent  simulator  to  be  "down"  =  simulatorTimeout,  90 
seconds. 


1.4  Connguration  and  ConFiguration  Management 

NOM  is  coded  in  the  "C"  programming  language.  It  makes  use  of  functions  from  standard 
"C",  UNIX  system  calls,  and  libraries  compiled  from  the  public  domain  source  of  X, 
version  11,  Release  4  (XI 1R4). 

NOM  currently  runs  under  Concurrent  Real  Time  Unix  (RTU)  version  4.0A.  In  most 
cases  it  will  only  require  a  recompile  to  operate  with  other  versions  of  RTU. 

The  full-featured  NOM  configuration  consists  of  a  5600  Concurrent  host,  a  large  capacity 
(380mb)  disk  drive,  a  large  capacity  (140mb)  tape  drive.  Communications  Machinery 
Corporation  ethemet  card,  a  serial  control  unit,  and  a  high  resolution  graphics  monitor. 
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Auxiliary  files>-/simnet/data 
. .  ./nom/NOM-pars ; 

This  is  an  input  parameter  file  that  each  site  must  create  for  configuring  NOM  at  start-up. 
Entries  are: 

terrain  <database_name> 

This  entry  is  used  to  set  the  terrain  database  the  NOM  will  use  during  its  operation. 

vehicle  <site>  <host>  <row>  <column>  <enei_addr>  <lamp_addr> 

This  entry  is  required  for  each  simulator  icon.  The  site,  and  host.fields  are  the  site  ID  and 
host  ID  assigned  to  a  simulator.  These  are  found  in  the  .../assoc.def  file  on  the  simulator. 
Row  and  column  identify  the  trailer  location  of  the  simulator,  the  field  enet_addr  is  the 
complete  ethemet  address  of  a  simulator,  and  the  lamp_addr  is  the  lamplighter  address  of 
the  simulator  in  decimal. 

..  ./nom/NOM_state : 

This  is  a  NOM  output  file,  which  stores  the  last  values  set  from  the  "Options"  command. 


1.5  Terminology  and  Documentation 

1.5.1  Terms 

and  Abbreviations 

bit  map 

pattern  of  bit  settings  which  determine  a  visual  display.  Each  "on"  bit 
turns  on  a  picture-element  (pixel). 

bitbll 

bit  block  transfer. 

client 

a  user's  application  program. 

CSC 

Computer  Software  Component.  A  distinct  part  of  a  computer  software 
configuration  item  (CSCI).  CSCs  may  be  funher  decomposed  into 
other  CSCs  and  Computer  Software  Units  (CSUs). 

CSCI 

Computer  Software  Configuration  Item.  A  configuration  item  for 
computer  software. 

csu 

Computer  Software  Unit.  An  element  of  a  (Computer  Software 
Component  (CSC)  that  is  separately  te.stable. 

fb 

frame  buffer  (graphics  programming). 

heartbeat 

indications  that  a  host  is  alive  and  running;  response  PDUs  sent  from  a 
SIM  host  to  the  NOM  are  used  to  indicate  presence  or  absence  of  a  SIM 
host  heartbeat. 

host/Host 

mainframe 

IF 

Interface 

IPC 

Inter-Process  Control.  A  protocol  for  local  conmiunications  between 
NOM  subsystems. 

Man-Man 

Manager-Manager  Protocol 

NOM 

Network  Operations  and  Maintenance. 

PDU 

Protocol  Data  Unit. 

plane 

in  graphics  programming,  'plane'  refers  to  a  block  of  raster  memory  for 
storing  a  bit  map.  One  memory  plane  allows  two  bit-settings  per  pixel  - 
on  or  off  Multiple  planes  provide  multiple  bit  settings  per  pixel, 
multiple  planes  are  used  to  achieve  hue,  layering,  or  depth  effects. 

Protocol 

a  set  of  procedures  and  data  formats  that  govern  data  communications. 
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resource 

segment 

server 

sheU 

SIM  host 
Subscription 


socket 

Toolkit 

UI 

UTM 

Widgets 

YUMM 


in  windows  programming,  a  resource  is  a  complex  shareable  set  of  data 
structures  that  defines  a  window  object. 

in  graphics  programming,  'segment'  refers  to  set  of  related  graphics 
commands. 

a  program  that  controls  the  graphics  system.  A  server  acts  as  an 
intermediary  between  a  client  and  system  resources, 
a  UNIX  command  interpreter. 

simulator  host  (vehicle  or  Management  Cbmmand  and  Control), 
membership  of  a  simulation  entity  in  a  multicast  group;  subscribing  and 
unsubscribing  are  SIMNET  network  services  provided  by  the  Slhfi^T 
association  protocol. 

used  in  communications;  implemented  as  a  message  address, 
contains  sets  of  X-Window  options,  each  set  controlling  an  aspect  of 
windows,  for  example,  a  window's  geometry. 

User  Interface 
Universal  terrain  meridian 

X- Window  "objects"  such  as,  menus,  scrollbars,  and  buttons. 

Part  of  /simnet/rcs/lib/libipc.a  (Section  2.5. 3.6).  Contains  routines  for 
message  passing. 


1.5.2  References 

The  following  documents  are  relevant  to  an  understanding  of  the  NOM  and  its 
implementation  in  "C": 

•  The  "C"  Programming  Language.  Kemighan  and  Ritchie,  Prentice-Hall,  1978. 

•  DOD-STD-2167A  &  Associated  DIDs  and  DOD-STD-2168  &  Associated  DID. 
David  Maibor  Associates,  Needham  Heights,  MA,  February  29, 1988. 

•  Introducing  UNIX  SYSTEM  V.  Rachel  Morgan  and  Henry  McGilton,  New 
York,  McGraw-Hill,  1987 

•  "SIMNET  Data  Collection  and  Review,"  BBN  STC,  CX:tober  1988. 

•  The  SIMNET  Maintenance  Manual,  version  6.2,  March  1990. 

•  "SIMNET  Network  and  Protocols,"  BBN  Report  No.  1702. 
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2  NOM  CSC  DESCRIPTIONS 

In  this  section,  top-level  CSCs  are  decomposed  into  lower-level  CSCs  and  CSUs.  Each 
CSU  is  generally  mapped  to  a  source  file  or  library.  The  contents  of  each  CSU  are 
summarized. 

Some  top-level  CSCs  are  broken  down  into  lower-level  CSCs.  At  the  end  of  each  top-level 
CSC  description,  a  breakdown  into  lower-level  CSCs,  if  any,  is  shown,  and  each  lower- 
level  CSC  functionally  summarized.  If  there  are  no  lower-level  CSCs  corresponding  to  the 
top-level  CSC,  it  is  decomposed  into  one  or  more  CSUs.  If  there  are  lower-level  CSUs, 
each  of  these,  in  turn,  is  decomposed  into  one  or  more  CSUs. 

Interfacing  Constraints: 

NOM  interfaces  are  designed  to  be  as  modular  as  possible.  This  constrains  the 
representation  of  NOM  interfaces  as  follows: 

1)  Design  elements  at  the  same  level  of  hierarchy  are  represented  as  interfacing  directly 
only  with  their  design  peers;  that  is,  a  top-level  CSC  is  represented  as  interfacing 
directly  only  with  other  top-level  CSCs,  a  lower-level  CSC  is  represented  as 
interfacing  directly  with  other  lower-level  CSCs,  and  a  CSU,  as  interfacing  directly 
only  with  other  CSUs. 

2)  Design  peers  subordinated  under  different  parent  nodes  are  represented  as 
interfacing  with  one  another  only  through  their  parent  nodes.  For  example,  a  CSU 
does  not  interface  directly  with  a  CSU  belonging  to  a  different  CSC;  instead,  the 
CSUs  interface  through  their  parent  CSCs. 

CSU  function  calls  represents  an  exception  to  the  second  constraint.  One  function  may  call 
any  other  function  within  its  scope  of  linkage. 

File  linkage: 

MAP,  GUI,  lamplighter_int.,  and  NOM  Comms,  are  linkage  units.  These  linkage  units 
also  link  to  libraries  under  NOM-level  processes  (Section  2.5). 
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Decomposition  of  NOM  CSCI  into  its  top-level  CSCs  is  illustrated  in  Figure  2-1. 


Figure  2-1:  NOM  CSCI  Structure. 

Interfaces  among  the  NOM  top-level  CSCs  are  illustrated  in  Figure  1 .3-2,  "NOM  Internal 
Interfaces." 
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2.1  Graphical  User  Interface  (GUI)  CSC  Description 

The  graphical  user  interface  (GUI)  is  a  separate  process  in  the  NOM,  which  is  used  to 
accept  commands  from  a  human  user,  respond  to  those  commands,  and  alert  the  user  to 
asynchronous  events  which  the  NOM  is  monitoring. 

GUI  organizes  the  screen  into  three  main  areas;  a  menu  panel,  a  drawing  area,  and  an 
auxiliary  window  area.  The  drawing  area  provides  a  Mac-like  interface  for  creating  a 
floorplan  of  each  site's  simulator  layout.  The  menu  area  provides  commands  for  simulator 
controls  and  simulator  windows  for  on-demand  status  display  and  remote  SIM  terminal 
login.  Operations  which  use  an  auxiliary  window  create  a  scrollable  vtlOO  simulation 
window.  GUI  uses  the  entire  screen;  however,  a  user  has  access  to  any  commands  which 
may  be  run  on  the  particular  NOM  host. 

GUI  makes  requests  of  the  MAP  using  action  requests.  If  the  action  can  be  performed 
immediately,  the  MAP  does  so,  and  returns  an  actSuccess  or  actFailure  return  code.  If  the 
request  will  take  some  time,  the  MAP  returns  a  response  with  an  actAcknowledge  return 
code.  If  the  request  subsequently  fails,  an  event  is  sent  to  the  user  interface. 

GUI  interfaces  with  the  communications  subsystem;  it  uses  this  subsystem's  protocol  to 
truest  interactive  login  capability  to  remote  simulators,  quit  the  open  termini  session,  and 
display  command  input  coming  from  a  console  locally  attached  to  a  SIMNET  host.  GUI 
continuously  displays  information  related  to  simulators  and  maintained  in  shared  memory 
by  the  management  application  process  (see  Section  2.2,  below).  GUI  also  updates  the 
current  threshold  values  for  equipment  status  values  which  will  generate  alarms.The  GUI 
queries  state  information  in  shar«l  memory  in  order  to  display  simulator  icons  with  the 
appropriate  state  character. 

Events: 

A  technician  can  view  a  system  events  log  maintained  by  MAP  CSC  (Section  2.2)  and  an 
outstanding  events  log  for  a  selected  simulator.  Outstanding  events  are  the  ten  most  recent 
events  not  yet  acknowledged  by  GUI  (by  selecting  the  Clear  Events  option).  The 
outstanding  events  log  can  hold  up  to  ten  outstanding  events;  the  eleventh  (newest)  event 
will  erase  event  one  from  this  log. 

Events  that  the  MAP  determines  to  be  'important'  signify  a  SIM  state  change,  which  causes 
a  color-coded  alarm  display. 
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Functional  breakdown  of  GUI  into  lower-level  CSCs  is  illustrated  in  Figure  2.1-1. 


Figure  2.1-1;  GUI  CSC  Structure 
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2.1.1  Menu  Handling  CSC  Description 

This  lower-level  CSC  displays  menu  items  and  processes  menu  selections.  Menu  items 
include  management  operations,  and  are  used  to  specify  auxiliary  window  and  drawing 
area  options.  Additional  popup  screens  are  sometimes  used  to  gather  additional  user  input. 

A  functional  breakdown  of  this  lower-level  CSC  into  CSUs  is  shown  in  Figtire  2. 1.1-1. 


Menu 

Handling 

2.1.1 

panel.c 

screens.c 

panel.h 

screens.h 

2.1.1.1 

2.1. 1.8 

2.1.1.15 

2.1.1.21 

draw  menu.c 

modes.c 

2.1. 1.9 

draw  menu.h 

modes.h 

2.1.1.22 

2.1 .1.2 

2.1.1.16 

mission.h 

slm_menu.c 

activate.c 

2.1.1.10 

sIm  menu.h 

2.1.1.23 

2.1 .1.3 

mlsslon.c 

2.1.1.17 

activate.h 

2.1.1.24 

win_menu.c 

2.1.1.11 

win  menu.h 

2.1. 1.4 

options.c 

2.1.1.18 

options.h 

sys_monu.c 

sys_menu.h 

2.1.1.25 

2.1.1 .5 

misc.  menu.c 

2.1. 1.6 

2.1.1.12 

powerdown.c 

2.1.1.13 

2.1.1.19 

shutdown.h 

screensP.h 

2.1.1.20 

2.1.1.26 

selections.h 

shutdown.c 

2.1.1.7 

2.1.1.14 

Figure  2.1. 1-1:  GUI-Menu  Handling. 

2. 1.1.1  panel.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  governs  the  entire  control  panel,  which  includes  menus  and  auxiliary  windows. 

2. 1.1. 1.1  panel_InitPanei 

This  routine  initializes  the  command  panel  of  the  GUI,  including  the  mode,  command,  and 
action  submenues.  The  label  is  creat^.  The  left-hand  side  panel,  the  middle  panel,  and  the 
right-hand  side  panel  are  created,  their  widths  are  calculated,  and  their  menus  are  placed. 
The  routine  returns  0  if  successful  and  an  error  code  if  unsuccessful. 
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1  Parameters  1 

Parameter 

Where  Typedef  Declared 

parent 

Widaet 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

returnCode 

ErrorCode 

Unsuccessful 

0 

int 

Successful 

1  Calls  1 

Function 

Where  Described 

XtCreateWidaet 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

XtCreateManaaedWidaet 

public  domain  source  of  X,  version  1 1 .  Release  4  (XI 1R4) 

XtAddActions 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtOverrideT  ranslations 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

misc  InitMenu 

misc  menu.c 

draw  InitMenu 

draw  menu.c 

svs  InitMenu 

svs  menu.c 

win  InitMenu 

win  menu.c 

Sim  InitMenu 

draw  menu.c 

mode  InitMenu 

modes. c 

Table  2.1-1:  paneI_InitPanel  Information. 
2. 1.1. 1.2  panel_SetupPanel 


This  routine  finishes  initializing  the  Panel  after  the  environment  has  stabilized.  The  routine 
returns  0  if  successful  and  an  error  code  if  unsuccessful. 


1  Return  Values  1 

Return  Value 

Meaning 

returnCode 

ErrorCode 

If  0,  routine  was  successful; 
othenrvise,  routine  was 
unsuccessful. 

panel  ReflectCurrentSelectio 
n() 

ErrorCode 

If  0,  routine  was  successful; 
otherwise,  routine  was 
unsuccessful. 

1  Calls  1 

Function 

Where  Described 

mode  SetupMenu 

modes.c 

Sim  SetupMenu 

draw  menu.c 

win  SetupMenu 

win  menu.c 

draw  SetupMenu 

draw  menu.c 

SYS  SetupMenu 

svs  menu.c 

misc  SetupMenu 

misc  menu.c 

Table  2.1-2:  panel_SetupPanel  Information. 
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2. 1.1. 1.3  Panel  ReflectCurrentSelection 


This  routine  reflects  the  state  of  the  currently  selected  simulators  in  the  control  panel, 
making  the  available  selection  contect-dependent,  based  upon  the  currently  selected 
equipment.  The  routine  returns  0  if  successful  and  an  error  code  if  unsuccessful. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

returnCode 

ErrorCode 

unsuccessful 

0 

int 

Successful 

Calls 

Function 

Where  Described 

win  ReflectCurrentSelection 

win  menu.c 

Sim  ReflectCurrentSelection 

draw  menu.c 

Table  2.1-3:  panel_RefIectCurrentSeIection  Information. 

2. 1.1. 1.4  panel_LabelVis 

This  callback  routine  is  invoked  whenever  the  canvas  gets  a  window  exposed  event  from 
X. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

widaet 

Widqet 

event 

pointer  to  XVisibilitvEvent 

params 

pointer  to  String 

HIHHHHHHHHiHHi 

nparams 

pointer  to  Cardinal 

1 

1  Calls  1 

■  Function 

Where  Described 

win  menu.c 

sys  menu.c 

Table  2.1-4:  paneI_LabelVis  Information. 


2.1. 1.2  draw_menu.c  CSU  Description  (/simnet/cmd/nom/gui) 
This  CSU  controls  menu  items  related  to  the  drawing  area. 
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2. 1.1. 2.1  draw  GetWidth 


This  routine  returns  the  maximum  length  (in  pixels)  needed  to  hold  a  state  item  menu  entry. 
The  number  of  pixels  used  by  the  longest  en^  are  calculated  and  then  padding  is  added. 


1  Return  Values  1 

Return  Value 

Meanina 

char  width(normalFont)*niaxc 
bars)  +  2*ITEM_HORZ_PAD 

int 

The  maximum  length  needed 
to  hold  a  state  item  menu 
entry. 

1  Calls  1 

Function 

Where  Described 

char  width 

Table  2.1-5:  draw  GetWidth  Information. 


2. 1.1. 2. 2  draw  InitMenu 


This  routine  initializes  the  command  menu  in  the  GUI  panel.  A  constructor  is  created  for 

the  entire  menu.  menuArgs  is  initialized  with  the  pass^  constraints.  The  header  label  is 

created  for  the  state  menu.  A  widget  is  added  for  each  state  entry  item  in  the  menu.  The 

fields  in  the  state  entry  are  initialized.  The  widget  ID  of  the  created  menu  is  output  into 

widget.  The  routine  reaims  0  if  successful  and  an  error  code  if  unsuccessful.  Parameters 

are  represented  as  follows: 

parent  —  The  parent  constructor  widget 

spacing  -  The  spacing  (in  pixels)  from  the  attached  widget 

attach  —  The  widget  to  which  to  attach  (or  align  next  to) 

width  "  The  width  of  the  menu 

widget  -  The  output  action  menu  widget  ED 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

parent 

Widget 

spacing 

int 

Standard 

attach 

Widget 

width 

int 

Standard 

widget 

pointer  to  Widget 

1  Return  Values  1 

Return  Value 

Meaning 

0 

int 

Successful 

1  Calls  1 

Function 

Where  Described 

XtCreateManagedWidget 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtNumber 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-6:  draw_InitMenu  Information. 
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2. 1.1. 2. 3  draw_SetupMenu 

This  routine  initializes  the  popup  menus. 


1  Return  Values  1 

Return  Value 

Type 

Meanina 

mode_PopupSetup(menuWi 

dqet) 

ErrorCode 

0  if  successful;  error  code 
otherwise. 

Calls 

Function 

Where  Described 

mode  PopupSetup 

modes.c 

Table  2.1-7:  draw_SetupMenu  Information. 

2. 1.1. 2. 4  draw_Select 

This  callback  routine  is  called  when  the  user  selects  a  menu  item  from  the  menu.  This 
routine  dispatches  to  the  appropriate  subprocessing. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

widget 

Widget 

iteminfo 

pointer  to  Iteminfo 

draw  menu.c 

1  Calls  1 

Function 

Where  Described 

mode  PopupDisplav 

modes.c 

file  WriteCurrentFile 

file.c 

1 

canvas.c 

icon  SelectAII 

icons.c 

icon  DeleteSelected 

icons. c 

canvas  Revert 

canvas.c 

icon  DropOn 

icons.c 

icon  NameOn 

icons.c 

icon  SelectOn 

icons.c 

grid  Toggle 

grid.c 

put  msg 

msqsw.c 

DISPLAY  ERROR 

Table  2.1-8:  draw_Select  Information. 

2. 1.1.3  sim_menu.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  creates  and  manages  a  menu  block  which  contains  commands  for  controlling 
simulators. 
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2.1. 1.3.1  Sim  GetWidth 


This  routine  returns  the  maximum  length  (in  pixels)  needed  to  hold  an  item  menu  entry. 
The  number  of  pixels  used  by  the  longest  en^  are  calculated  and  then  padding  is  added. 


1  Return  Values  1 

Return  Value 

Type 

Meanina 

tmpi  *2*ITEM_HORZ_PAD 

int 

The  maximum  length  needed 
to  hold  an  item  menu  entry 

tmp2*2*ITEM_HORZ_PAD 

int 

The  maximum  length  needed 
to  hold  an  item  menu  entry 

Calls 

Function 

Where  Described 

char  width 

Table  2.1-9:  sim  GetWidth  Information. 


2. 1.1. 3. 2  sim  InitMenu 


This  routine  initializes  the  action  menu  in  the  GUI  panel.  A  constructor  is  created  for  the 
entire  menu.  menuArgs  is  initialized  with  the  passed  constraints.  The  header  label  is 
created  for  the  menu.  A  widget  is  added  for  each  entry  item  in  the  menu.  The  fields  in  the 
entry  are  initialized.  The  widget  ID  of  the  created  menu  is  output  into  widget.  The  routine 
returns  0  if  successful  and  an  error  code  if  unsuccessful.  The  submodules  are  initialized. 
Parameters  are  represented  as  follows: 

”  The  parent  constructor  widget 
”  The  spacing  (in  pixels)  from  the  attached  widget 
”  The  widget  to  which  to  attach  (or  align  next  to) 

”  The  width  of  the  menu 
--  The  output  action  menu  widget  ID 


parent 

spacing 

attach 

width 

widget 
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1  Calls  1 

Function 

Where  Described 

XtCreateManaaedWidqetn 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtNumber 

public  domain  source  of  X.  version  1 1 ,  Release  4  (X1 1 R4) 

activate  Init 

activate. c 

powerdown  Init 

powerdown  .c 

mission  Init 

mission.c 

shutdown  Init 

shutdown. c 

Table  2.1-10:  siin_InitMenu  Information. 

2. 1.1. 3. 3  sim_SetupMenu 

This  routine  finishes  intializing  the  menu  after  the  rest  of  the  environment  has  stabilized. 
The  routine  returns  0  if  successful  and  an  error  code  if  unsuccessful. 


I  Return  Values  I 

Return  Value 

Type 

Meaning 

returnCode 

ErrorCode 

Unsuccessful 

0 

int 

Successful 

Calls 

Function 

Where  Described 

activate  Setup 

activate.c 

powerdown  Setup 

powerdown.c 

shutdown  Setup 

shutdown.c 

mission  Setup 

mission.c 

Table  2.1-11:  sim_SetupMenu  Information. 

2 . 1 . 1 . 3 . 4  simReflectCurrentSelection 

This  routine  reflects  the  state  of  the  currendy  selected  equipment  in  the  menu,  making  the 
menu  context-sfiecific.  The  appropiate  menu  entries  are  activated,  depending  upon  how 
manu  valid  pieces  of  equipment  are  selected  by  the  user.  If  no  valid  equipment  pieces  are 
selected,  no  commands  can  be  performed.  The  number  of  pieces  of  equipmnent  includes 
both  the  number  of  simulators  and  the  number  of  icons.  The  routine  returns  0  if  successful 
and  an  error  code  if  unsuccessful. 


I  Return  Values  I 

Return  Value 

Type 

Meaning 

0 

int 

Successful 

Calls 

Function 

Where  Described 

equip  GetNumSelected 

equipment. c 

XtSetValues 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtNumber 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-12:  sim  RcflectCurrentSelection  Information. 
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2.1. 1.3.5  sini_SeIect 

This  callback  routine  is  called  when  the  user  selects  a  menu  item  from  the  action  menu. 
This  routine  dispatches  to  the  appropriate  subprocessing.  If  ACTIVATE  is  selected  for  a 
single  simulator,  the  user  can  perform  a  parameterized  activation.  Otherwise  only  test 
activations  with  predetermined  settings  are  allowed.  If  SEL_DOWN  is  selected,  the  user 
must  choose  between  emergency  and  normal  power  down. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

widaet 

Widaet 

iteminfo 

pointer  to  Iteminfo 

1  Calls  1 

Function 

Where  Described 

switch 

equip  GetNumSelected 

equipment. c 

activate  OisplavTest 

activate.c 

activate  DisplavParams 

activate.c 

powerdown  OisplayChoice 

powerdown.c 

shutdown  OisplayChoice 

shutdown.c 

mission  OisplayChoice 

mission.c 

act  SendActionloSelected 

actions.c 

Table  2.1-13:  sim  Select  Information. 


2. 1.1. 4  win_menu.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  controls  menu  items  using  auxiliary  vtlOO  windows.  These  windows  are  used 
for  status  information,  error  log  history,  and  terminal  passthrough. 

2.1. 1.4.1  win_GetWidth 

This  routine  returns  the  maximum  length  (in  pixels)  needed  to  hold  a  state  item  menu  entry. 
The  number  of  pixels  used  by  the  longest  en^  are  calculated  and  then  padding  is  added. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

char_width(normalFont)  * 
maxChars)  + 

2*ITEM  HORZ  PAD 

int 

The  maximum  length  needed 
to  hold  a  state  item  menu 
entry. 

Calls 

Function 

Where  Described 

char  width 

Table  2.1-14:  win  GetWidth  Information. 
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2. 1.1. 4. 2  win_InitMenu 

This  routine  initializes  the  action  menu  in  the  GUI  panel.  A  constructor  is  created  for  the 

entire  menu.  menuArgs  is  initialized  with  the  passed  constraints.  The  header  label  is 

created  for  the  menu.  A  widget  is  added  for  each  entry  item  in  the  menu.  The  fields  in  the 

entry  are  initialized.  The  widget  ID  of  the  created  menu  is  output  into  widget  The  routine 

returns  0  if  successful  and  an  error  code  if  unsuccessful.  The  submodules  are  initialized. 

Parameters  are  represented  as  follows: 

parent  —  The  parent  constructor  widget 

spacing  --  The  spacing  (in  pixels)  from  the  attached  widget 

attach  -  The  widget  to  which  to  attach  (or  align  next  to) 

width  -  The  width  of  the  menu 

widget  —  The  output  acdon  menu  widget  ID 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

parent 

Widget 

spacing 

int 

Standard 

attach 

Widget 

width 

int 

Standard 

widget 

pointer  to  Widget 

1  Return  Values  1 

Return  Value 

Meaning 

0 

int 

Successful 

1  Calls  1 

Function 

Where  Described 

XtCreateManagedWidget 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

XtNumber 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

sys  Inititems 

sys  menu.c 

Table  2.1-15:  win_InitMenu  Information. 

2.1. 1.4.3  win_SetupMenu 

This  routine  finishes  initializing  the  menu  after  the  rest  of  the  environment  has  stabilized. 
This  routine  must  be  called  after  the  initial  current  selection  has  been  established.  The 
routine  returns  0  if  successful  and  an  error  code  if  unsuccesssful. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

sys_SetupMenu() 

ErrorCode 

If  0,  successful;  if  an  error 
code,  unsuccessful. 

Calls 

Function 

Where  Described 

sys_.SetupMenu 

sys  menu.c 

Table  2.1-16:  win_Se(upMenu  Information. 
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2 . 1 . 1 . 4 . 4  win_ReflectCurrentSelection 

This  routine  reflects  the  state  of  the  currently  selected  equipment  in  the  menu,  making  the 
menu  context-specific.  The  appropiate  menu  entries  are  activated,  depending  upon  how 
manu  valid  pieces  of  equipment  are  selected  by  the  user.  The  number  of  pieces  of 
equipmnent  includes  both  the  number  of  simulators  and  the  number  of  icons.  Since  all 
entries  are  currently  implemented  as  xterms  and  only  one  is  allowed  at  a  time,  the  entire 
menu  is  disabled  if  xterm  is  present  Terminal  passthrough  can  only  be  selected  if  exactly 
one  valid  piece  of  equipment  is  selected.  If  no  valid  equipment  is  selected,  no  commands 
can  be  performed.  The  routine  returns  0  if  successful  and  an  error  code  if  unsuccessful. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

int 

Successful 

Calls 

Function 

Where  Described 

equip  GetNumSelected 

equipment.c 

XtSet  Values 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

XtNumber 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-17:  win  ReflectCurrentSelection  Information. 


2. 1.1. 4. 5  win_XtermNotify 

This  routine  is  called  in  order  to  reflect  xterm  menu  items  appropriately  whenever  an  xterm 
is  created  or  destroyed.  Only  one  xterm  application  at  a  time  is  allow^. 


I  Parameters  I 

Parameter 

Where  Typedef  Declared 

present 

int 

Standard 

Calls 

Function 

Where  Described 

win  ReflectCurrentSelection 

win  menu.c 

Table  2.1-18:  win_XtermNotify  Information. 

2. 1.1. 4. 6  win_ItemSeIect 

This  callback  routine  is  called  when  the  user  selects  a  menu  item  from  the  action  menu. 
This  routine  dispatches  to  the  appropriate  subprocessing. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

widget 

Widqet 

iteminfo 

pointer  to  Iteminfo 
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1  Calls  1 

Function 

Where  Described 

exec  RemoteTerminal 

exec.c 

equip  GetFirstSelected 

equipment.c 

DISPLAY  ERROR 

exec  ViewFile 

exec.c 

Table  2.1*19:  win_IteinSeIect  Information. 

2.1. 1.5  sys_menu.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  controls  system-wide  menu  items. 

2. 1.1. 5.1  sys_GetWidth 

This  routine  returns  the  maximum  length  (in  pixels)  needed  to  hold  a  state  item  menu  entry. 
The  number  of  pixels  used  by  the  longest  en^  are  calculated  and  then  padding  is  added. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

char  width(normalFont)*maxC 
bars  +  2*ITEM_HORZ_PAD 

int 

The  maximum  length  needed 
to  hold  a  state  item  menu 
entry. 

Calls 

Function 

Where  Described 

char  width 

Table  2.1*20:  sys_GetWidth  Information. 

2. 1.1. 5. 2  sys_InitMenu 

This  routine  initializes  the  menu  in  the  GUI  panel.  The  widget  ID  of  the  created  menu  is 

output  into  widget.  A  constructor  is  created  for  the  entire  menu.  menuArgs  is  initialized 

with  the  passed  constraints.  The  header  label  is  created  for  the  menu.  The  widget  ID  of  the 

created  menu  is  output  into  widget.  The  routine  returns  0  if  successful  and  an  error  code  if 

unsuccessful.  Parameters  are  represented  as  follows: 

parent  -  The  parent  constructor  widget 

spacing  —  The  spacing  (in  pixels)  from  the  attached  widget 

aa^h  -  The  widget  to  which  to  attach  (or  align  next  to) 

width  —  The  widUi  of  the  menu 

widget  -  The  output  action  menu  widget  ID 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

parent 

Widqet 

spacinq 

int 

Standard 

attach 

Widget 

width 

int 

Standard 

widqet 

pointer  to  Widqet 
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1  Return  Values  1 

Return  Value 

Meaning 

0 

int 

Successful 

1  Calls  1 

Function 

Where  Described 

XtCreateManaaedWidaet 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtNumber 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

sys  Inititems 

sys  menu.c 

Table  2.1>21:  sys_InitMenu  Information. 

2.1. 1.5.3  sys^Initltems 

This  routine  is  called  by  sys  InitMenu  to  add  a  widget  for  each  state  entry  item  in  the 
menu  and  initalize  the  fields  ih  the  state  entry. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

menu 

Widaet 

width 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

XtNumber 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtCreateManaaedWidaet 

public  domain  source  of  X.  version  1 1 ,  Release  4  (X1 1  R4l 

Table  2.1-22:  sys_lnitltems  Information. 


2. 1.1. 5. 4  sys_Setupmenu 

This  routine  always  returns  0. 


I  Return  Values  I 

Return  Value 

Type 

Meaning 

0 

int 

always  returned 

Table  2.1-23:  sys_SetupMenu  Information. 

2. 1.1. 5. 5  sys_XtermNotify 

This  routine  is  called  in  order  to  reflect  xterm  menu  items  appropriately  whenever  an  xterm 
is  created  or  destroyed.  Only  one  xterm  application  at  a  time  is  allow^.  The  window  can 
be  closed  if  present.  The  window  cannot  be  created  if  present. 


I  Parameters  | 

Parameter 

Where  Typedef  Declared 

present 

int 

Standard 
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1  calls  1 

Function 

Where  Described 

XtSetValues 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtNumber 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-24:  sys_XterinNotify  Information. 
2. 1.1. 5. 6  sys_Select 


This  callback  routine  is  caUed  when  the  user  selects  a  menu  item  from  the  menu.  This 
routine  dispatches  to  the  appropriate  subprocessing. 


I  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

widaet 

Widaet 

iteminfo 

pointer  to  Iteminfo 

SYS  menu.c 

Calls 

Function 

Where  Described 

exec  OpenAuxiliarvWindow 

exec.c 

exec  ViewFile 

exec.c 

exec  CloseAuxiliarvWindow 

exec.c 

put.  msq 

msqsw.c 

Table  2.1-25:  sys_Select  Information. 

2. 1.1. 6  misc_menu.c  CSU  Jesciption  (/simnet/cmd/nom/gui) 

This  CSU  supports  the  Miscellaneous  menu. 

2.1. 1.6.1  misc_InitMenu 

This  routine  initializes  the  commnad  menu  in  the  GUI  panel.  A  constructor  is  created  for 
the  entire  menu.  menuArgs  is  initialized  with  the  pass^  constraints.  The  header  label  is 
created  for  the  menu.  A  widget  is  added  for  each  entry  item  in  the  menu.  The  fields  in  the 
entry  are  initialized.  The  widget  ED  of  the  created  menu  is  output  into  widget.  The  routine 
returns  0  if  successful  and  an  error  code  if  unsuccessful.  The  auxiliary  screens  are 
initialized.  Parameters  are  represented  as  follows: 


parent 

—  The 

spacing 

-  The 

attach 

-  The 

width 

"  The 

widget 

“  The 
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Parameter 


arent 


soacin 


attach 


width 


widoet 


Parameters 


e 


Widoet 


int 


Widoet 


mt 


inter  to  Widoet 


Where  Tvpedef  Declared 


Standard 


Standard 


Return  Values 


Return  Value 


Meanin 


Successful 


Function 


XtCreateManaoedWidoet 


XtNumber 


opt  I  nit 


Calls 


Where  Described 


blic  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4 


ubiic  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4 


ODtions.c 


Table  2.1-26:  misc_InitMenu  Information. 
2. 1.1. 6. 2  misc_SetupMenu 

This  routine  initializes  the  auxiliary  screens. 


Return  Value 

Type 

opt  Setup(optionslnfo.widget 
) 

ErrorCode 

Meanin 


0  if  successful;  error  code  if 
unsuccessul. 


Function 


opt  Setu 


Calls 


Where  Described 


options.c 


Table  2.1-27:  misc_SetupMenu  Information. 

2. 1.1. 6. 3  misc_Select 

This  callback  routine  is  called  when  the  user  selects  a  menu  item  from  the  action  menu. 
This  routine  dispatches  to  the  appropriate  subprocessing. 


Parameter 


widoet 


iteminfo 


Parameters 


e 


Widoet 


inter  to  Iteminfo 


irs 


Where  Tvoedef  Declared 


misc  menu.c 


Function 


ut  ms 


Calls 


Where  Described 


options.c 


msosw.c 


Table  2.1-28:  misc  Select  Information. 
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2. 1.1. 7  selections.h  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  is  included  in  all  the  menu  module  files  (draw_menu,  sim_menu,  sys_menu, 
etc).  It  uniquely  defines  all  the  menu  selections.  TTiis  global  name  space  was  adopted  to 
facilitate  rearranging  menus  and  putting  menu  items  in  different  menus. 

2. 1.1.8  screens.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  provides  generic  support  for  popup  screens. 

2.1. 1.8.1  Initialize 

This  routine  initializes  a  new  screen  widget.  TTie  label  of  the  new  screen  widget  is 
initialized.  A  form,  consisting  of  a  label  and  entry  field  next  to  each  other,  is  added  for 
each  field  record. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

requst 

Widaet 

dw 

ScreenWidaet 

Calls 

Function 

Where  Described 

XtMalloc 

public  domain  source  of  X.  version  1 1 .  Release  4  (X1 1 R4) 

XtCreateWidaet 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

XtNumber 

public  domain  source  of  X,  version  1 1 ,  Release  4  {X1 1 R4) 

Max 

Xtcreate  Manaaed  Widaet 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtManaaeChildren 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1*29:  Initialize  Information. 

2. 1.1. 8. 2  Constraintinitialize 

This  routine  adds  constraints  to  the  initialization.  The  routine  gets  a  handle  to  the  last  child 
of  the  screen  (either  a  field  or  a  button).  If  the  last  child  is  not  a  button,  use  the  defaults.  If 
the  child  is  a  button  (however,  not  the  first  button),  add  horizontal  contstrain. 


1  Parameters  I 

[Parameter 

Type 

Where  Typedef  Declared 

request 

Widaet 

1  new 

Widqet 

Calls 

Function 

Where  Described 

XtlsSubclass 

public  domain  source  of  X.  version  1 1 ,  Release  4  (X1 1 R4) 

XtlsManaqed 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-30:  Constraintinitialize  Information. 
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2. 1.1. 8. 3  SetValues 


This  routine  is  not  used  in  the  version  6.6  release. 


1  Parameters  I 

Parameter 

Where  Tvnedef  Declared 

current 

Widqet 

request 

Widget 

new 

Widget 

Table  2.1-31:  SetValues  Information. 
2.1. 1.8.4  XtScreenGetValueString 

This  routine  returns  the  value  string  of  the  field  pointer  passed  in  field. 


1  Parameters  | 

Parameter 

Where  Tvpedef  Declared 

widget 

ScreenWidget 

field 

int 

Standard 

1  Return  Values  I 

Return  Value 

Meaning 

fieldRr->value 

pointer  to  char 

The  value  string  of  field 

Table  2.1-32: 


XtScreenGetValueString  Information. 


2. 1.1. 8. 5 


XtScreenSetValue 


This  routine  replaces  the  current  value  of  a  specified  field  in  a  screen  with  the  new  value. 
widget  specifies  the  screen;  field  specifies  the  field;  newVal  specifies  the  new  value. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

widget 

ScreenWidget 

field 

int 

Standard 

newVal 

pointer  to  char 

Standard 

Calls 

Function 

Where  Described 

XtTextReolace 

public  domain  source  of  X.  version  1 1 ,  Release  4  (Xi  i  R4) 

XtTextSetInsertionPoint 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-33:  XtScreenSetValue  Infomation. 
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2.1. 1.8.6  XtScreenAddButton 

This  routine  adds  a  button  to  the  screen  specified  by  screen. 


1  Parameters  I 

Parameter 

Tvoe 

Where  Typedef  Declared 

screen 

Widaet 

name 

pointer  to  char 

Standard 

functionO 

pointer  to  function  that  returns 
void 

Standard 

param 

caddr  t 

Calls 

Function 

Where  Described 

XtCreateManaaedWidqet 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

XtNumber 

public  domain  source  of  X.  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-34:  XtScreenAddButton  Information. 


2. 1.1. 9  modes.c  CSU  Description  (/simnet/emd/nom/gui) 

This  CSU  provides  a  popup  screen  for  selecting  "drawing  mode"  Drawing  nxxies  are: 
creating  vehicle  icons;  naming  icons  using  a  cursor  in  pencil  mode;  and,  toggling  grid- 
snap. 

Pencil  mode  is  supported  by  the  parameters  file,  MCC-Pars.  This  file  resides  in  the  NOM, 
and  is  read  by  NOM  when  a  user  attempts  to  write  a  name  in  a  SIM  icon.  The  Pars  file 
includes  the  following  parameters:  Ethernet  address,  SIM  number,  and  type  of  vehicle,  for 
all  SIMs  on  site;  and,  the  Ethernet  address  of  the  MCC  hosts  on  site.  Only  valid  SIM 
names  contained  in  the  Pars  ile  of  a  site  can  be  written  in  a  SIM  icon. 

The  ml,  grid,  and  pencil  bitmaps  are  used  by  the  modes  popup  screen  as  graphical  menu 
items  which  the  user  may  select. 

2. 1.1. 9.1  mode_GetWidth 

This  routine  returns  the  necessaiy  width  of  the  mode  menu  area.  The  routine  assumes  all 
icons  are  the  same  size  and  returns  the  width  needed  for  one  mode  icon. 


I  Return  Values  I 

Return  Value 

Type 

Meaning 

items[0].icon->width 

int 

The  width  needed  for  one 
mode  icon. 

Table  2.1-35:  mode  GetWidth  Information. 
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Parameter 


arent 


lEIT! 


e 


Widaet 


Where  Tvoedef  Declared 


Return  Value 


returnCode 


mode_SetupMenu() 


Return  Values 


e 


ErrorCode 


ErrorCode 


Meanin 


unsuccessful 


If  0,  successful;  if  error  code, 
unsuccessful 


Function 


XTranslateCoordi  nates 


XtWindow 


XDefaultRootWindow 


XtSetAr 


XtCreatePoDuoShell 


Mode  InitMenu 


XtCreateManaaedWidaet 


XtNumber 


ir 

ir 

in 

in 

in 

in 

in 


Calls 


Where  Described 


blic  domain  source  of  X.  version  1 1 .  Release  4  (X1 1 R4 


ubiic  domain  source  of  X.  version  1 1 .  Release  4  (X1 1 R4 


ubiic  domain  source  of  X.  version  1 1 .  Release  4  fX1 1 R4 


blic  domain  source  of  X.  version  1 1 ,  Release  4  (X1 1 R4 


ubiic  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4 


modes.c 


ubiic  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4 


ubiic  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4 


Table  2.1-36:  mode_PopupSetup  Information. 
2. 1.1. 9. 3  mode_PopupDisplay 

This  routine  displays  the  popup  menu. 


Function 


XtPODU 


Calls 


Where  Described 


ubiic  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4 


Table  2.1-37:  mode_PopupDisplay  Information. 
2.1. 1.9.4  mode_PopupRemove 

This  routine  removes  the  popup  menu. 


Calls 


Function  Where  Described 


XtPopdown  _  public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4 


Table  2.1-38:  mode  PopupRemove  Information. 
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2.1. 1.9.5  inode_InitMenu 

This  routine  initializes  the  mode  menu  for  selecting  diffemet  GUI  modes  (i.e.  grid, 

selection,  and  icon  naming).  The  menu  holder  is  created.  The  necessary  pad^g  to  use  up 

the  allowed  width  is  calculated.  The  header  label  for  the  state  menu  is  created,  ^ch  of  the 

iconic  menu  items  is  created.  The  routine  returns  0  if  successful  and  an  error  code  if 

unsuccessful.  Parameters  are  represented  as  follows: 

parent  -  The  parent  constructor  widget 

spacing  —  The  spacing  (in  pixels)  from  the  attached  widget 

attach  —  The  widget  to  which  to  attach  (or  align  next  to) 

width  -  The  wallowed  width  of  the  mode  menu  area 

widget  —  The  output  action  menu  widget  ID 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

parent 

Widget 

spacing 

int 

Standard 

attach 

Widget 

width 

int 

Standard 

widget 

pointer  to  Widget 

1  Return  Values  I 

Return  Value 

Meaning 

0 

ErrorCode 

Successful 

1  Calls  1 

Function 

Where  Described 

mode  GetWidth 

modes.c 

XtCreateManagedWidget 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtNumber 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-39:  mode_InitMenu  Information. 

2.1. 1.9.6  mode_SetupMenu 

This  routine  completes  the  initialization  of  the  mode  menu  after  some  required  external 
processing  has  been  performed.  The  normal  and  inverse  video  pixmaps  are  created. 
Pixmaps  are  used  for  command  buttons,  cursors  and  icon  diplays.  The  routine  returns  0  if 
successful  and  an  error  code  if  unsuccessful. 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

ErrorCode 

Successful 

* 

Calls 

Function 

Where  Described 

XtSetArg 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtGetValues 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

XCreatePixmapFramBitmapDa 

ta 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Xt  Window 

public  domain  source  of  X.  version  1 1 .  Release  4  (X1 1 R4) 

OefaultOeothOf  Screen 

XtSetValues 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-40:  mode_SetupMenu  Information. 


2.1. 1.9.7  mode  IsActive 


This  routine  returns  whether  the  current  mode  is  currently  selected  and  active. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

mode 

inf 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

items[mode].on 

int 

Whether  the  current  mode  is 
selected. 

Table  2.1-41:  mode  IsActive  Information. 


2. 1.1. 9. 8  mode_DisplayHelp 


This  routine  displays  the  passed  help  text  as  the  primary  mode  message.  This  text  should 
be  refreshed  after  any  transient  error  messages  overwrite  it  temporarily. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

help 

pointer  to  char 

Standard 

Calls 

Function 

Where  Described 

put  msg 

msgsw.c 

Table  2.1-42:  mode  DisplayHelp  Information. 
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2. 1.1. 9. 9  mode  RefreshMode 


This  routine  refreshes  the  current  mode 


help. 


1  Calls  1 

1  Function  1 

Where  Described 

msqsw.c 

Table  2.1-43:  mode_RefreshMode  Information. 
2.1.1.9.10  mode_DispIayError 

This  routine  displays  a  transient  error  in  the  display  area. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

error 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

put  msq 

msqsw.c 

Table  2.1-44:  mode  DisplayError  Information. 
2.1.1.9.11  mode  ItemSelect 


This  routine  handles  the  selection  of  an  item  on  the  specified  screen. 


Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

widqet 

Widqet 

s 

pointer  to  F  switch 

Calls 

Function 

Where  Described 

switch  actions 

Table  2.1-45:  mode  ItemSelect  Information. 


2.1.1.9.12  init  switch 

This  routine  handles  the  initialization  of  the  switches. 


1  Calls  i 

Fi’  ictlon 

Where  Described 

turn  on 

modes. c 

Table  2.1-46:  init  switch  Information. 
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2.1.1.9.13  get_grid 

This  routine  toggles  the  grid  on  and  off. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

sw 

pointer  to  F  switch 

Calls 

Function 

Where  Described 

grid  Togqie 

Qrid.c 

Table  2.1-47:  set_grid  Information. 
2.1.1.9.14  turn_on 

This  routine  turns  on  the  passed  switch. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

s 

pointer  to  F  switch 

1  Calls  1 

Function 

Where  Described 

XtSetValues 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-48:  turn  on  Information. 


2.1.1.9.15  turn_off 

This  routine  turns  off  the  passed  switch. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

s 

pointer  to  F  switch 

Calls 

Function 

Where  Described 

XtSetValues 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-49:  turn  off  Information. 
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2.1.1.9.16  switch  action 


This  routine  handles  the  passed  switch  action. 


Table  2.1-50:  function  Information. 

2.1.1.10  activate.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  provides  a  popup  screen  for  setting  activate  options.  This  CSU  uses  an 
auxiliary  screen  to  options  accessable  by  the  user  for  the  activation  of  a  single  icon.  A 
minimum  of  attributes  are  available  since  the  NOM  activation  is  intended  as  a  "trial" 
activation  used  by  technical  support,  rather  than  exercise  starting  activations  which  should 
be  performed  through  the  MCC.  The  user  may  activate  multiple  simulators  at  once, 
however,  only  automatically  calculated  values  may  be  used  for  the  options  (which  are 
different  for  each  simulator).  These  values  are  calculated  by  the  MAP  in  the  Mini  CSC. 

2.1.1.10.1  activate_Init 

This  routine  initializes  the  widget  screen.  The  routine  returns  0  if  successful  and  an  error 
code  if  unsuccessful. 


Return  Values 

Return  Value 

Type 

Meaning 

0 

ErrorCode 

successful 

code 

ErrorCode 

unsuccessful 

Table  2.1-51:  activate  Init  Information. 


2.1.1.10.2  activate_Setup 

This  routine  finishes  the  initialization  after  widgets  have  been  realized.  The  screen  is 
displayed  relative  to  the  widget  parent..  The  auxiliary  screen,  used  to  set  values  for  an 
activation,  is  created.  The  confirmation  screen,  used  when  multiple  icons  are  selected  for 
activation,  is  created.  The  routine  returns  0  if  successful  and  an  error  code  if  unsuccessful. 
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1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

parent 

Widqet 

1  Return  Values  1 

Return  Value 

Meaning 

0 

ErrorCode 

successful 

code 

ErrorCode 

unsuccessful 

1  Calls  1 

Function 

Where  Described 

XTranslate  Coordinates 

public  domain  source  of  X.  version  1 1 ,  Release  4  (X1 1 R4) 

XDefault  RootWindow 

public  domain  source  of  X.  version  1 1 .  Release  4  {X1 1 R4) 

XtSetArq 

public  domain  source  of  X.  version  1 1 ,  Release  4  (X1 1 R4) 

XtCreatePopupShell 

public  domain  source  of  X,  version  1 1 .  Release  4  (Xl  1 R4) 

XtCreate  M  anaaed  Widqet 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtNumber 

public  domain  source  of  X,  version  1 1 ,  Release  4  (Xl  1 R4) 

XtScreenAddButton 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-52:  activate_Setup  Information. 
2.1.1.10.3  activate_DisplayTest 

This  routine  provides  the  user  with  an  auxiliary  screen,  used  to  confirm  that  the  user 
wishes  to  activate  multiple  simulators  with  test  values. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

ErrorCode 

successful 

code 

ErrorCode 

unsuccessful 

Calls 

Function 

Where  Described 

XtPopup 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

Table  2.1-53:  activate_DispIayTest  Information. 

2.1.1.10.4  activate_DisplayParams 

This  routine  provides  the  user  with  an  Activation  parameters  screen  filled  with  appropriate 
default  values  for  the  single  selected  resource,  equip  represents  the  equipment  whose 
default  values  to  display;  birf  represents  a  formatting  buffer  for  field  values.  The  message 
to  request  default  activation  parameter  values  for  the  passed  equipment  is  filled  in,  and  then 
the  routine  blocks,  awaiting  the  default  activation  parameters  for  the  currently  selected 
resource. 
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1  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

equip 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

ErrorCode 

successful 

code 

ErrorCode 

unsuccessful 

1  Calls  1 

Function 

Where  Described 

act  ActionReqPDUFill 

actions.c 

DISPLAY  ERROR 

MMP  Transact 

MMP.c 

XtScreenSetValue 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

XtPopup 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-54:  activate_DisplayParains  Information. 
2.1.1.10.5  activate  ConfirmParam 


This  routine  is  called  when  the  user  clicks  on  the  "Confirm"  button  for  the  activate  screen. 
The  routine  resets  the  current  NOM  and  GUI  options  to  the  values  currently  reflected  in  the 
options  screen.  The  Activate  request  is  based  on  the  request  used  to  get  default  values. 

Tlie  values  returned  for  the  paramameters  query  request  are  copied.  The  format  of  the  input 
is  checked.  The  location  is  checked  to  make  sure  that  the  point  is  actually  on  the  terrain. 
Once  the  input  has  been  accepted,  the  screen  is  taken  down  and  the  activation  request  is 
sent  to  the  MA  process. 


I  Calls  I 

I  Function 

Where  Described  I 

sizeof 

XtScreenGetValueStrinq 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

AlignStrinqToAliqn 

DISPLAY  ERROR 

libtdb  in  MCC  CSCI 

tdb  error 

libtdb  in  MCC  CSCI 

tdb  p  on  database 

libtdb  in  MCC  CSCI 

XtPopdown 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

MMP  Transact 

MMP.c 

Table  2.1-55:  activate  ConfirmParam  Information. 
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2.1.1.10.6  activateCancelParam 

This  routine  is  called  when  the  user  clicks  on  the  "Cancel"  button  for  the  activation  screen. 
The  routine  performs  any  necessary  cleanup. 


1  Calls  1 

Function 

Where  Described 

XtPopdown 

public  domain  source  of  X.  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-56:  activate_CancelParain  Information. 
2.1.1.10.7  activate_CancelTest 

This  routine  is  called  when  the  user  clicks  on  the  "No"  button  for  the  test  confirmation 
screen.  The  routine  performs  any  necessary  cleanup. 


1  Calls  1 

Function 

Where  Described 

XtPopdown 

public  domain  source  of  X.  version  1 1 .  Release  4  (X1 1 R4) 

Table  2.1-57:  actlvate_CanceITest  Information. 
2.1.1.10.8  activate_ConfirmTest 

This  routine  is  called  when  the  user  clicks  on  the  "Yes"  button  for  the  test  confirmation 
screen.  The  mechanism  for  testing  the  activate  all  selected  simulators  is  initiated. 


I  Calls  I 

Function 

Where  Described 

XtPopdown 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

act  SendActionToSelected 

actions.c 

Table  2.1-58:  activate_ConfirmTest  Information. 

2.1.1.11  mission.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  provides  a  popup  screen  for  setting  simulator  Mission  Capable  State.  This  file 
uses  an  auxiliary  input  screen  to  select  the  current  mission  capability  status.  If  the  state 
selected  is  not  the  Mission  Capable  state,  the  simulator  is  displayed  as  yellow,  even  if  the 
simulator  is  alarmed.  This  prevents  nonoperative  simulators’  alarms  from  distracting  the 
NOM  operator. 

2.1.1.11.1  mission_Init 

This  routine  initializes  the  widget  screen.  The  routine  always  returns  0. 


1  Return  Values  I 

Return  Value 

Meaning 

0 

ErrorCode 

Always  returns  0 

Table  2.1-59:  mission  Init  Information. 
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2.1.1.11.2  niission_Setup 

This  routine  completes  the  initialization  after  the  widgets  have  been  realized.  The  routine 
returns  0  if  successful  and  an  error  code  if  unsuccessful.  The  screen  is  displayed  relative  to 
the  widget  parent.  The  auxiliary  screen,  used  to  select  the  type  of  mission,  is  created. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

parent 

Widget 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

ErrorCode 

Successful 

1  Calls  1 

Function 

Where  Described 

XT  ranslateCoordi  nates 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

XDefaultRootWindow 

public  domain  source  of  X.  version  1 1 ,  Release  4  (X1 1 R4) 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

XtCreatePopupShell 

public  domain  source  of  X.  version  1 1 .  Release  4  (X1 1 R4) 

XtCreateManaaedWidget 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

XtNumber 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtScreenAddButton 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-60:  mission_$etup  Information. 

2. 1.1.1 1.3  mission_DispIayChoice 

This  routine  provides  the  user  with  an  auxiliary  screen  used  to  choose  the  type  of  mission 
desired.  The  routine  returns  0  if  successful. 


I  Return  Values  I 

Return  Value 

Type 

Meaning 

0 

ErrorCode 

Successful 

Calls 

Function 

Where  Described 

XtPopup 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-61:  mission_DisplayChoice  Information. 

2.1.1.11.4  mission_CancelChoice 

This  routine  is  called  when  the  user  clicks  on  the  "Cancel"  button  for  the  choice  of  mission 
screen.  The  routine  performs  any  necessary  cleanup. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

widget 

Widget 

clientData 

caddr  t 

callData 

caddr  t 
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1  Calls  1 

Function 

Where  Described 

XtPopdown 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

Table  2.1-62:  niission_CanceIChoice  Information. 
2.1.1.11.5  mission_SetStatus 

This  routine  is  called  when  the  user  clicks  on  a  mission  status  for  the  selected  simulators. 
The  callback  param  is  the  state  to  be  set.  equip  is  a  pointer  to  the  equipment  in  the 
nomEquipInfo  table;  index  is  the  index  of  equipment  in  the  nomEquipInfo  table. 


I  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

widoet 

Widoet 

clientData 

caddr  t 

callData 

caddr  t 

I  Calls  1 

Function 

Where  Described 

XtPopdown 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

icon  IsSelected 

icons.c 

equip  ReflectEquipState 

equipment. c 

Table  2.1-63:  mission_SetStatus  Information. 

2.1.1.12  options.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  provides  a  popup  screen  for  setting  NOM  options  (reporting  thresholds).  The 
file  supports  the  Options  auxiliary  screen  used  to  set  the  current  operating  options  for  the 
NOM  and  GUI.  Currently,  this  file  only  sets  NOM-wide  threshold  parameters. 

2.1.1.12.1  opt_Init 


This  routine  initializes  the  options  screen.  The  routine  aiw«^s  returns  0. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

0 

ErrorCode 

successful 

Table  2.1-64:  opt_Init  Information. 
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2.1.1.12.2  opt_Setup 

This  routine  sets  up  the  options  screen  after  widgets  have  been  realized.  The  routine 
returns  0  if  successful  and  an  ErrorCode  if  unsuccessful.  The  screen  is  displayed  relative 
to  the  widget  parent. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

parent 

Widaet 

Return  Values 

Return  Value 

Type 

Meaning 

0 

ErrorCode 

successful 

Calls 

Function 

Where  Described 

XT  ranslateCoordinates 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtWindow 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XDefaultRootWindow 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtSetAra 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtCreatePoDupShell 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

XtCreateManaaedWidqet 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtNumber 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

XtScreenAddButton 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1*65:  opt_Setup  Information. 

2.1.1.12.3  opt_Display 

This  routine  reloads  the  current  values  for  the  NOM  shmem  table.  The  routine  returns  0  if 
successful. 


I  Return  Values  | 

Return  Value 

Type 

Meaning 

0 

ErrorCode 

successful 

Calls 

Function 

Where  Described 

XlScreenSetValue 

public  domain  source  of  X.  version  1 1 .  Release  4  (X1 1 R4) 

Xt  Popup 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

Table  2.1-66:  opt_Display  Information. 
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This  routine  is  called  when  the  user  clicks  on  the  "Confirm"  button  for  the  options  screen. 
The  current  NOM  and  GUI  options  are  reset  to  the  values  currently  reflected  in  the  optiMis 
screen.  The  routine  returns  0  if  successful. 


Function 


XtScreenGetValueStri 


DISPLAY  ERROR 


Calls 


Where  Described 


blic  domain  source  of  X.  version  1 1 ,  Release  4  {X1 1 R4 


Table  2.1*67:  opt_Confirm  Information. 

2.1.1.12.5  opt_Cancel 

This  routine  is  called  when  the  user  clicks  on  the  "Cancel”  button  for  the  options  screen. 
The  routine  performs  any  necessary  cleanup  and  aborts  the  option  setting. 


Function 


XtPoDdown 


lit 


Calls 


Where  Described 


ubiic  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4 


Table  2.1-68:  opt_Cancel  Information. 

2.1.1.13  powerdown.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  handles  processing  related  to  powering  down  simulators.  A  popup  screen  is 
provided  for  selecting  powerdown  option.  This  auxiliary  screen  selects  the  type  of 
powerdown  or  the  cancellation  of  the  operation. 

2.1.1.13.1  powerdown_Init 
This  routine  always  returns  0. 

2.1.1.13.2  powerdown_Setup 

This  routine  completes  the  initialization  after  widgets  have  been  realized.  The  routine 
returns  0  if  successful  and  an  error  code  if  unsuccessful.  The  auxiliary  screen  used  to 
select  the  type  of  powerdown  is  created.  The  screen  is  displayed  relative  to  the  widget 
parent. 
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1  Calls  1 

Function 

Where  Described 

XTranslateCoordinates 

public  domain  source  of  X.  version  1 1 ,  Release  4  (X1 1 R4) 

XtWindow 

public  domain  source  of  X.  version  1 1 .  Release  4  (Xl  1 R4) 

XDefaultRootWindow 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtSetAra 

public  domain  source  of  X.  version  1 1 .  Release  4  (X1 1 R4) 

XtCreatePoDuoShell 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtCreateManaaedWidqet 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtNumber 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtScreenAddButton 

public  domain  source  of  X.  version  1 1 .  Release  4  (X1 1 R4) 

Table  2.1>69:  powerdown_Setup  Information. 
2.1.1.13.3  powerdown_DisplayChoice 

This  routine  provides  the  user  with  an  auxiliary  screen  used  to  choose  the  typ>e  of 
powerdown  desired.  The  routine  returns  0  if  successful  and  an  error  code  if  not 
successful. 


I  Return  Values  I 

Return  Value 

Type 

Meaning 

0 

ErrorCode 

Successful 

Calls 

Function 

Where  Described 

Xt  Popup 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-70:  powerdown_DisplayChoice  Information. 
2.1.1.13.4  powerdown_CancelChoice 

This  routine  is  called  when  the  user  clicks  on  the  "Cancel"  button  for  the  choice  of 
powerdown  screen.  The  routine  performs  any  necessary  cleanup. 


1  Calls  1 

Function 

Where  Described 

XtPopdown 

public  domain  source  of  X,  version  1 1 ,  Release  4  (Xl  1 R4) 

Table  2.1-71: 


powerdown_CancelChoice  Information. 
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2.1.1.13.5  powerdown_Emergency 


This  routine  is  called  when  the  user  clicks  on  the  "Emergency"  button  for  the  choice  of 
powerdown  screen.  The  routine  performs  any  necessary  cleanup. 


1  Calls  1 

Function 

Where  Described 

XtPopdown 

public  domain  source  of  X.  version  1 1 .  Release  4  (X1 1 R4) 

act  SendActionToSelected 

actions.c 

Table  2.1<72:  powerdown_Emergency  Information. 
2.1.1.13.6  powerdown_Normal 


This  routine  is  called  when  the  user  clicks  on  the  "Normal"  button  for  the  choice  of 
powerdown  screen.  The  routine  performs  any  necessary  cleanup. 


I  Calls  I 

Function 

Where  Described 

XtPopdown 

public  domain  source  of  X.  version  1 1 ,  Release  4  (X1 1 R4) 

act  SendActionToSelected 

actions.c 

Table  2.1-73:  powerdown_Normal  Information. 

2.1.1.14  shutdown.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  provides  a  popup  screen  for  selecting  shutdown  option.  The  file  handles  the 
necessary  processing  for  shutting  down  simulators. 

2.1.1.14.1  shutdown_Init 
This  routine  always  returns  0. 

2.1.1.14.2  shutdown_Setup 

This  routine  completes  the  initialization  after  widgets  have  been  realized.  The  routine 
returns  0  if  successful  and  an  error  code  if  unsuccessful.  The  auxiliary  screen  used  to 
select  the  type  of  shutdown  is  created.  The  screen  is  displayed  relative  to  the  widget 
parent. 


1  Parameters  j 

Parameter 

Type 

Where  Typedef  Declared 

parent 

Widqet 

Return  Values 

Return  Value 

Type 

Meaning 

0 

ErrorCode 

Successful 
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1  Calls  1 

Function 

Where  Described 

XT  ranslateCoordinates 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

XDef  au  It  Root  Wi  ndow 

public  domain  source  of  X,  version  1 1 .  Release  4  {X1 1 R4) 

XtSetAra 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

XtCreatePopupShell 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtCreateManaoedWidaet 

public  domain  source  of  X.  version  1 1 ,  Release  4  (X1 1 R4) 

XtNumber 

public  domain  source  of  X.  version  1 1 ,  Release  4  (X1 1 R4) 

XtScreenAddButtons 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1<74:  shutdown_Setup  Information. 

2.1.1.14.3  shutdown_DisplayChoice 

This  routine  provides  the  user  with  an  auxiliary  screen  used  to  choose  the  type  of  shutdown 
desired.  The  routine  returns  0  if  successful  and  an  error  code  if  not  successful. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

ErrorCode 

Successful 

Calls 

Function 

Where  Described 

XtPopup 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-75:  shutdown_DisplayChoice  Information. 
2.1.1.14.4  shutdown_CancelChoice 

This  routine  is  called  when  the  user  clicks  on  the  "Cancel"  button  for  the  choice  of 
shutdown  screen.  The  routine  performs  any  necessary  cleanup. 


I  Return  Values  I 

Return  Value 

Type 

Meaning 

0 

ErrorCode 

Successful 

Calls 

Function 

Where  Described 

XtPopdown 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-76:  shutdown  CancelChoice  Information. 
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2.1.1.13.5  shutdown_Confirni 

This  routine  is  called  when  the  user  clicks  on  the  "Confirm"  button  for  the  choice  of 
shutdown  screen.  The  routine  performs  any  necessary  cleanup. 


1  Calls  1 

Function 

Where  Described 

XtPopdown 

Dublic  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

act  SendActionToSelected 

actions.c 

Table  2.1-77:  shutdown  Coniirm  Information. 


2.1.1.15  panel.h  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  is  the  interface  file  for  panel.c.  (See  2. 1.1.1.) 

2.1.1.16  draw_menu.h  CSU  Description  (/simnet/cmd/nom/gui) 
This  CSU  is  the  interface  file  for  draw_menu.c.  (See  2. 1.1. 2.) 

2.1.1.17  sim_menu.h  CSU  Description  (/simnet/cmd/nom/gui) 
This  CSU  is  the  interface  file  for  sim_menu.c  .  (See  2.1.1  3.) 

2.1.1.18  win_menu.h  CSU  Description  (/simnet/cmd/nom/gui) 
This  CSU  is  the  interface  file  for  win_menu.c.  (See  2. 1.1. 4.) 

2.1.1.19  sys_menu.h  CSU  Description  (/simnet/cmd/nom/gui) 
This  CSU  is  the  interface  file  for  sys_menu.c.  (See  2. 1.1. 5.) 

2.1.1.20  screensP.h  CSU  Description  (/simnet/cmd/nom/gui) 
This  file  is  a  private  header  file  that  includes  screens.h. 

2.1.1.21  screens.h  CSU  Description  (/simnet/cmd/nom/gui) 

This  file  is  the  interface  file  for  screei.’.c.  (See  2.1. 1.8) 

2.1.1.22  modes.h  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  is  the  interface  file  for  modes.c.  (See  2. 1.1. 9.) 

2.1.1.23.  mission.h  CSU  Description  (/simnet/cmd/nom/gui) 
This  CSU  is  the  interface  file  for  mission.c.  (See  2. 1.1.1 1.) 

2.1.1.24  activate.h  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  is  the  interface  file  for  activate.c.  (See  2.1.1.10.) 


51 


BBN  Systems  and  Technologies 


Network  Operations  and  Maintenance  CSCI 


2.1.1.25  options.h  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  is  the  interface  file  for  options.c.  (See  2.1.1.12.) 

2.1.1.26  shutdown.h  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  is  the  interface  file  for  shutdown.c.  (See  2.1.1.14.) 

2.1.2  Drawing  Area  Input  Handling  CSC  Description 

This  lower-level  CSC  enables  a  technician  to  create  a  floor  plan  of  a  site's  simulators.  It 
includes  software  that  supports  creating,  naming,  positioning,  as  well  as  selection,  of 
simulator  symbols. 

A  functional  breakdown  of  this  lower-level  CSC  into  CSUs  is  shown  in  Figure  2. 1.2-1. 
The  Drawing  Area  Input  Handling  CSC  uses  the  ml.bitmap,  nml.bitmap,  and  nm2.bitmap 
files.  Additionally,  this  CSU  references  msgsw.c  and  msgsw.h  (Section  2. 1.5.2  and 
Section  2. 1.5.8). 


Drawing  Area  Input  Handling 

2.1.2 

canvas,  h 

canvas.c 

paintop.h 

2.1.2.1 

2. 1.2.9 

2.1.2.17 

file.h 

file.c 

xglobals.h 

2.1. 2.2 

2.1.2.10 

2.1.2.18 

text.h 

text.c 

xtra.c 

2.1. 2.3 

2.1.2.11 

2.1.2.19 

char.h 

char.c 

2.1.2.4 

2.1.2.12 

blink. c 

cursor.h 

2.1.2.5 

cursor.c 

2.1.2.13 

2.1.2.20 

grid.h 

2.1.2.6 

grid.c 

2.1.2.14 

icons.h 

icons.c 

2.1.2.7 

2.1.2.15 

states,  h 

2  1.2  8 

states.c 

2.1.2  16 

Figure  2. 1.2-1:  (ILT— Drawing  Area  Input  Handling. 
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2. 1.2.1  canvas.h  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  is  the  interface  file  for  canvas.c.  (See  2. 1.2.9.) 

2. 1.2.2  file.h  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  is  the  interface  file  for  file.c.  (See  2.1.2.10.) 

2. 1.2.3  text.h  CSU  Descri.ition  (/simnet/cmd/nom/gui) 

This  CSU  is  the  interface  file  for  text.c.  (See  2. 1.2.1 1.) 

2. 1.2. 4  char.h  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  is  the  interface  file  for  char.c.  (See  2.1.2.10.) 

2. 1.2. 5  cursor.h  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  is  the  interface  file  for  cursor.c.  (See  2.1.2.13.) 

2. 1.2. 6  grid.h  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  is  the  interface  file  for  grid.c.  (See  2. 1.2.6.) 

2. 1.2. 7  icons.h  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  is  the  interface  file  for  icons.c.  (See  2.1.2.16.) 

2. 1.2. 8  states.h  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  is  the  interface  file  for  states.c.  (See  2.I.2.8.) 

2. 1.2. 9  canvas.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  is  responsible  for  the  entire  canvas  area.  This  file  supports  the  Macdraw-hke 
GUI  drawing  area.  The  drawing  canvas  for  the  site  depiction  in  the  NOM  GUI  is 
supported.  The  user  is  allowed  to  draw  a  floor  plan  of  all  the  simulators  being  managed. 
Note  that  the  module  icon.c  provides  much  of  the  functionality  of  this  CSU. 

2. 1.2. 9.1  canvas_InitCanvas 

This  routine  initializes  the  canvas,  which  is  the  drawing  area  or  site  depiction  area  of  the 
graphich  UI.  The  routine  gets  the  RGB  values  for  recolor  cursor  use.  The  routine  returns 
0  if  successful  and  an  error  code  if  unsuccessful. 
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1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

widget 

Widget 

1  Return  Values  1 

Return  Value 

Meaning 

iconJnitIconsO 

ErrorCode 

If  0,  then  successful; 
otherwise,  unsuccessful 

1  Calls  1 

Function 

Where  Described 

XtCreateWidget 

public  domain  source  of  X.  version  1 1 ,  Release  4  (X1 1 R4) 

XtNumber 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1  R4i 

XtGetValues 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XQuervColors 

public  domain  source  of  X.  version  1 1 .  Release  4  (X1 1 R4) 

XSetState 

public  domain  source  of  X.  version  1 1 .  Release  4  (X1 1 R4) 

canvas  ClearCallbacks 

canvas.c 

XtAddActions 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtOverrideT  ranslations 

public  domain  source  of  X.  version  1 1 ,  Release  4  (X1 1 R4) 

XtParseT  ranslationT  able 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-78:  canvas  InitCanvas  Information. 


2. 1.2. 9. 2  canvas  ClearCallbacks 


This  routine  is  called  to  clear  all  callbacks  which  map  X  events  to  functions. 


2. 1.2. 9. 3  canvas_SetupCanvas 


This  routine  completes  the  initialization  of  the  canvas  area  of  the  GUI  after  the  X 
environment  and  globals  are  established.  The  routine  creates  the  drawing  area  and  provides 
a  handle  so  that  xwd  can  dump  the  drawing  area.  The  routine  returns  0  if  successful  and  an 
error  code  if  unsuccessful. 


I  Return  Values  I 

Return  Value 

Type 

Meaning 

icon_Sefuplcons 

ErrorCode 

If  0,  then  successful: 
othenvise,  unsuccessful 

Calls 

Function 

Where  Described 

XtWindow 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtStoreName 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

init  grid 

grid.c 

Table  2.1-79:  canvas  SetupCanvas  Information. 
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2. 1.2. 9. 4  canvas_Clear 

This  routine  completely  clears  (blanks  out)  the  drawing  area. 


Calls 


Function 


XClearArea 


Where  Described 


public  domain  source  ol  X.  version  1 1 .  Release  4  (X1 1 R4) 


Table  2.1-80:  canvas  Clear  Information. 


2. 1.2. 9. 5  canvas_Redisplay 

This  routine  completely  redisplays  the  contents  of  the  canvas  area. 


1  Calls  1 

Function 

Where  Described 

canvas  Clear 

this  file 

icon.  Redisplay  All 

icons.c 

Table  2.1-81:  canvas_Redisplay  Information. 
2. 1.2. 9. 6  canvas_Revert 

This  routine  reverts  the  canvas  to  the  initial  default  values. 


1  Calls  1 

Function 

Where  Described 

icon  DeieteAii 

icons.c 

file  LoadDefaultFile 

file.c 

icon  RedispiayAII 

icons.c 

paneLRefiectCurrentSelectio 

n 

panei.c 

Table  2.1-82:  canvas_Revert  Information 
2. 1.2. 9. 7  canvas_Exposed 

This  routine  is  called  when  the  canvas  receives  a  window  exposed  event  from  X. 


Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

widqet 

Widqet 

event 

pointer  to  XExposeEvent 

params 

pointer  to  Strinq 

pointer  to  Cardinal 

1 

Calls  1 

Function 

Where  Described 

canvas  Redisplay 

this  file 

Table  2.1-83:  canvas^Exposed  Information. 
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2. 1.2. 9. 7  canvas_Left 

This  routine  is  called  when  the  user  moves  the  cursor  out  of  the  canvas. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

widqet 

Widaet 

event 

pointer  to  XCmssinaEvent 

params 

1 

pointer  to  Cardinal 

1 

Table  2.1-84:  canvas  Left  Information. 


2. 1.2. 9. 8  canvas_Selected 

This  routine  handles  events  in  the  canvas.  The  routine  masks  off  irrelevant  Button  bits 
from  state.  The  remaining  bits  are  used  for  modifiers  (e.g.  Cntrl,  Shift,  Lock,  Mod  1-5). 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

widaet 

Widqet 

event 

pointer  to  XButtonEvent 

params 

pointer  to  Strinq 

pointer  to  Cardinal 

1 

Calls 

Function 

Where  Described 

XLookupStrinq 

public  domain  source  of  X.  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-85:  canvas  Selected  Information. 


2.1.2.10  file.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  saves  and  restores  current  canvas  depiction  to  file. 

2.1.2.10.1  file_LoadDefaultFile 

This  routine  loads  the  NOM  site  file  into  the  drawing  area.  If  SAFE_FILE  does  not  exist,  a 
blank  screen  is  brought  up.  The  routine  returns  0  if  sucessful  and  an  error  code  if 
unsuccessful. 
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1  Calls  1 

Function 

Where  Described 

icon  selecton 

icons.c 

file  LoadFile 

file.c 

Table  2.1-86:  file_LoadDefaultFile  Information. 


2.1.2.10.2  nie  LoadFile 


This  routine  loads  the  file  with  the  name  file  into  the  drawing  area,  jp  is  the  file  descriptor 
for  the  loaded  file;  lineBirf  holds  each  line  of  input.  The  routine  returns  0  if  successful  and 
an  error  code  if  unsuccessful. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

file 

pointer  to  char 

Standard 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

errno 

ErrorCode 

Unsuccessful 

Close(fp) 

ErrorCode 

If  0,  then  successful; 
othenwise,  unsuccessful 

1  Calls  1 

Function 

Where  Described 

icon.  DeleteAll 

icons.c 

icon  AddIconFromDesc 

icons.c 

Table  2.1-87:  rile_LoadFile  Information. 


2.1.2.10.3  file_WriteCurrentFile 

This  routine  saves  the  current  site  depiction  into  the  current  file.  The  routine  returns  0  if 
successful. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

errno 

ErrorCode 

Unsuccessful 

0 

ErrorCode 

Successful 

Calls 

Function 

Where  Described 

icon  AlllconsToFile 

icons.c 

Table  2.1-88:  rile_WriteCurrentFile  Information. 
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2.1.2.11  text.c  CSU  Description  (/simnet/cmd/nom/gui) 
This  CSU  supports  the  naming  of  icons. 

2.1.2.11.1  prefix_length 


This  routine  determines  the  character  length  of  the  prefix,  "c"  as  part  of  a  variable  or 
parameter  name  denotes  a  character  unit  and  "p"  denotes  a  pixel  unit. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

font 

pointer  to  SFontStruct 

strina 

pointer  to  char 

Standard 

where  p 

int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

where_c 

int 

The  character  length  of  the 
prefix. 

len_c 

int 

The  character  length  of  the 
prefix. 

1  Calls  1 

Function 

Where  Described 

pf  textwidth 

char  advance 

Table  2.1*89:  prefix_length  Information. 


2.1.2.12  char.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  provides  character  handling  routine  for  naming  icons  in  the  canvas  area. 
2.1.2.12.1  draw_cursor 

This  routine  draws  the  cursor  on  the  canvas  area  at  the  location  defined  by  x  and  y. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

X 

int 

Standard 

1 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

pw  vector 

Table  2,1-90:  draw  cursor  Information. 
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2.1.2.12.2  initialize  char  handler 


This  routine  initializes  the  canvas  area  character  handler. 


1  Parameters  I 

Parameter 

Where  Tvnedef  Declared 

P 

Window 

f 

pointer  to  XFontStmct 

(‘cr)() 

pointer  to  function  that  returns 
int 

Standard 

bx 

int 

Standard 

by 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

char  width 

char  heiaht 

turn  on  blinkinq  cursor 

blink.c 

Table  2.1-91:  initialize  char  handler  Information. 


2.1.2.12.3  terminate_char_handler 

This  routine  terminates  the  canvas  area  character  handler. 


1  Return  Values  1 

Return  Value 

Meaning 

char_received 

int 

Whether  the  character  was 
received 

1  Calls  1 

Function 

Where  Described 

turn  off  blinknq  cursor 

blink.c 

Table  2.1-92:  terminate  char  handler  Information. 


2.1.2.12.4  erase_ch&r’_string 


This  routine  erases  a  character  string  from  the  canvas  area. 


1  Calls  1 

Function 

Where  Described 

pw  text 

Table  2.1-93:  erase_char_string  Information. 
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2.1.2.12.5  draw_char_string 

This  routine  draws  a  character  string  on  the  canvas  area. 


1  Calls  1 

Function 

Where  Described 

pw  text 

move  blinking  cursor 

blink.c 

Table  2.1>94:  draw_char_string  Information. 

2.1.2.12.6  char_handler 

This  routine  is  used  to  enter  tag  names,  checking  on  string  tag  name  length  maximum. 


1  Parameters  | 

Parameter 

Type 

Where  Tvpedef  Declared 

c 

char 

Standard 

Calls 

Function 

Where  Described 

erase  char  strino 

char.c 

draw  char  string 

this  file 

put  .  msg 

msgsw.c 

Table  2.1*95:  char_handler  Information. 

2.1.2.13  cursor.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  creates  a  pool  of  cursors  that  may  be  grabbed  dynamically  by  any  widget. 

2.1.2.13.1  setup_cursor 

This  routine  sets  up  a  cursor  for  character  input. 


1  Calls  1 

Function 

Where  Described 

XCreateFontCursor 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XCreateBitmapFromData 

public  domain  source  of  X,  version  1 1 ,  Release  4  {X1 1 R4) 

XCreatePixmapCursor 

public  domain  source  of  X,  version  1 1 ,  Release  4  (Xl  1 R4) 

XRecolorCursor 

public  domain  source  of  X,  version  1 1 ,  Release  4  (Xi  1 R4) 

Table  2.1*96:  setup^cursor  Information. 


2.1.2.14  grid.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  maintains  canvas  backdrop  grid  for  the  grid-snap  option. 
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2.1.2.14.  init_grid 


This  routine  initializes  the  backdrop  grid  in  the  canvas  window. 


1  Calls  1 

Function 

Where  Described 

XtSetAra 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtGetValues 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XCreatePixmapFromBitmapDa 

ta 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

DefaultDepthOf  Screen 

XCreatePixmapFromBitmapDa 

ta 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-97:  inU_grid  Information. 
2.1.2.14.2  grid_SetValue 

This  routine  updates  the  mode  variable  to  record  grid_snap  mode. 


I  Parameters  | 

Parameter 

Where  Typedef  Declared 

arid 

int 

Standard 

I  Calls  1 

Function 

Where  Described 

XtSetValues 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-98:  grid_SetVaIue  Information. 
2.1.2.14.3  grid_Toggle 


This  routine  toggles  the  grid_snap  mode  on  and  off. 


I  Calls  I 

Function 

Where  Described 

arid_SetValue 

this  file 

Table  2.1-99:  grid_Toggle  Information. 

2.1.2.15  icons.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  supports  operations  on  canvas  icons.  Icons  represent  simulators  and  other 
resources  in  the  canvas. 
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2.1.2.15.1  icon  Initlcons 


This  routines  zeroes  out  any  addresses  left  in  the  NOM  shared  memory  from  the  last  GUI 
invocation.  The  routine  returns  0  if  successful. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

tool 

Widaet 

Return  Values 

Return  Value 

Type 

Meaning 

0 

ErrorCode 

Successful 

Table  2.1-100:  icon_InitIcons  Information. 

2.1.2.15.2  icon_SetupIcons 

This  routine  completes  the  initialization  of  the  canvas  area  of  the  GUI  after  the  X 
environmnet  and  globals  are  established.  The  table  of  colors,  used  to  distinguish  different 
states,  is  set  up.  Tlie  table  of  icons  for  different  types  is  set  up.  For  each  icon  state,  a 
normal  and  reverse  video  pixmap  is  created  for  display.  The  routine  returns  0  if 
successful. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

0 

ErrorCode 

Successful 

Calls 

Function 

Where  Described 

XCreatePixmapFromBitmapDa 

ta 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Default  OepthofScreen 

makegc 

Table  2.1-101:  icon_SetupIcons  Information. 

2.1.2.15.3  icon_GetNextSelIcon 

This  routine  iterates  through  the  icons  in  a  linked  list,  returning  the  next  selected  icon.  If 
NULL  is  passed  in,  the  routine  returns  the  first  existing  selected  icon. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

icon 

pointer  to  Iconinfo 

icons. c 

Return  Values 

Return  Value 

Type 

Meaning 

next 

pointer  to  char 

The  next  selected  icon 

0 

pointer  to  char 

The  first  existing  selected  icon 

Table  2.1-102:  icon  GetNextSellcon  Information. 
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2.1.2.15.4  icon_IsSelected 

This  routine  returns  whether  the  passed  icon  is  selected  ot  not. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

icon 

pointer  to  Iconinfo 

icons.c 

Return  Values 

Return  Value 

Type 

Meaning 

icon->selected 

int 

Whether  the  icon  is  selected 

Table  2.1-103:  icon_lsSelected  Information. 
2.1.2.15.5  icon_GetEquip 

This  routine  returns  icon's  equipment  index. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

icon 

pointer  to  Iconinfo 

icons.c 

Return  Values 

Return  Value 

Type 

Meaning 

icon->equip 

int 

The  equipment  idex  of  the 
icon 

Table  2.1-104:  icon_GetEquip  Information. 


2.1.2.15.6  icon_DropOn 

This  routine  is  called  when  the  user  selects  the  icon  in  the  panel.  The  routine  begins 
dropping  icons  in  the  canvas. 


1  Calls  1 

Function 

Where  Described 

canvas  ClearCallbacks 

canvas.c 

XDefineCursor 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

mode  DisplayHelp 

modes.c 

Table  2.1-105:  icon_DropOn  Information. 
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2.1.2.15.7  icon_SelectOn 

This  routine  is  called  when  the  user  deselects  the  current  mode  icon  in  the  panel.  The 
routine  stops  adding  objects  to  the  canvas.  The  icon  selection  mode  is  entered  after 
cleaning  up  from  the  previous  mode,  and  the  new  callbacks  are  set  for  selection  mode. 


1  Calls  1 

Function 

Where  Described 

canvas  ClearCalbacks 

canvas.c 

XDefineCursor 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

mode  OisplayHelp 

modes.c 

Table  2.1-106:  icon  SelectOn  Information. 


2.1.2.15.8  icon_NameOn 

This  routine  is  called  when  the  user  selects  the  pencil  icon.  The  routine  names  objects  in 
the  drawing  area. 


1  Calls  1 

Function 

Where  Described 

canvas  ClearCallbacks 

canvas.c 

XDefineCursor 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

mode  OisplayHelp 

modes.c 

char  heiqht 

char  width 

Table  2.1-107;  icon_NameOn  Information. 

2.1.2.15.9  icon_Draw 

This  routine  is  called  to  draw  the  passed  icon  in  the  canvas.  The  routine  is  used  for  initial 
depiction,  refreshing,  and  selection,  icon  is  the  icon  to  draw;  selection  is  used  as  an  index 
which  indicates  whether  the  icon  is  selected;  state  is  used  as  an  index  which  indicates  the 
state  of  the  icon;  type  is  the  type  of  icon  to  isplay  (i.e.  Ml,  M2,  etc.).  The  selection  index 
is  set  at  0  or  1.  The  state  of  the  icon  is  determined:  NMCS  has  the  highest  priority  for 
display  and  outstanding  alarms  has  second  highest  priority.  If  the  operating  state  is 
unkown,  the  state  is  set  to  unknown,  otherwise,  the  state  is  set  to  normal.  The  icon  is 
painted  using  the  appropriate  pixmaps  and  GCs  using  selection  and  state  as  indices. 
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1  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

icon 

pointer  to  IconInfo 

icons.c 

1  Calls  1 

Function 

Where  Described 

XCopvArea 

public  domain  source  of  X.  version  1 1 ,  Release  4  (X1 1 R4) 

pw  text 

ICON  NAME  X 

ICON  NAME  Y 

XDrawStrinq 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

ICON  STATE  X 

ICON  STATE  Y 

Table  2.1«108:  icon  Draw  Information. 


2.1.2.15.10  icon  AddIconToList 


This  routine  adds  the  passed  icon  to  the  passed  linked  list  of  icons. 


I  Parameters  I 

Parameter 

Where  Typedef  Declared 

iconList 

pointer  to  pointer  to  IconInfo 

icons.c 

icon 

pointer  to  IconInfo 

icons.c 

Table  2.1-109:  icon_AddIconToList  Information. 
2.1.2.15.11  icon_RedispiayAll 

This  routine  draws  all  icons  in  their  current  position,  with  the  exception  of  any  "moving 
icon". 


1  Calls  1 

Function 

Where  Described 

icon  Draw 

this  file 

Table  2.1-110:  icon_RedisplayAll  Information. 
2.1.2.15.13  icon_SeiectAII 

This  routine  selects  all  the  icons  in  the  drawing  area.  First,  all  icons  are  deselected,  with 
the  exception  of  any  icon  the  user  has  clicked  on.  The  selection  state  and  the  selection- 
specific  menus  are  updated. 


1  Calls  1 

Function 

Where  Described 

icon  RedisplayAII 

icons.c 

panel_ReflectCurrentSelectio 

n 

panel.c 

Table  2.1-111:  icon  SelectAll  Information. 
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2.1.2.15.14  icon_WriteIconsToFile 

This  routine  writes  descriptions  of  the  passed  list  of  icons  to  the  passed  file.  Each  icon  is 
saved  in  human-readable  format 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

icons 

pointer  to  Iconinfo 

icons.c 

file 

pointer  to  FILE 

Standard 

Table  2.1-112:  icon  WritelconsToFile  Information. 
2.1.2.15.15  icon_AllIconsToFile 

This  routine  writes  descriptions  of  all  current  icons  to  the  passed  file. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

file 

pointer  to  FILE 

Standard 

1  Calls  1 

Function 

Where  Described 

icon  WritelconsToFile 

icons. c 

Table  2.1-113:  icon_AIIIconsToFile  Information. 
2.1.2.15.16  icon_4ddIconFromDesc 

This  routine  adds  an  icon  to  the  global  icon  list,  given  a  string  description  of  the  icon,  icon 
is  the  icon  description  from  the  save  file;  x  and  y  hold  the  x  and  y  locations  for  each  icon; 
tag  holds  the  name  tag  string  from  the  save  file. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

desc 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

String  Equal 

string, c 

icon  Creafelcon 

icons.c 

iconAddIconToLisf 

icons.c 

Table  2.1-114;  icon  AddIconFromDesc  Information. 
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2.1.2.15.17  icon_DeleteAII 

This  routine  deletes  all  icons  from  the  drawing  canvas  and  clears  the  canvas,  icon  h  the 
current  icon;  next  is  the  next  icon  to  check;  indejc  is  the  index  into  the  NOM  shared  memoiy 
table.  The  current  selection  state  is  fixed  up  for  the  user,  including  context-specific 
selections. 


1  Calls  1 

Function 

Where  Described 

icon  Delete 

this  file 

canvas  Clear 

canvas.c 

Table  2.1-115:  icon_DeleteAII  Information. 

2.1.2.15.18  icon_DeleteSelected 

This  routine  deletes  all  selected  objects  from  the  drawing  canvas,  icon  is  the  current  icon; 
prior  is  the  prior  icon  in  the  list;  next  is  the  next  icon  to  check.  Any  icons  which  are 
selected  are  erased  and  deleted.  The  current  selection  state  is  fixed  up  for  the  user, 
including  context- specific  selections. 


1  Calls  1 

Function 

Where  Described 

icon  Erase 

this  file 

icon  Delete 

this  file 

panel_ReflectCurrentSelectio 

n 

panel.c 

Table  2.1-116:  icon  DeleteSelected  Information. 


2.1.2.15.19  icon_Drop 

This  routine  is  called  when  the  user  tries  to  drop  an  icon  in  the  canvas.  The  routine  gets 
user's  intended  location  for  the  icon,  creates  an  unnamed  icon  in  the  appropriate  position, 
draws  the  icon,  and  records  the  icon  in  the  icon  list. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

X 

int 

Standard 

1 

int 

Standard 

Calls 

Function 

Where  Described 

canvas  ClearCallbacks 

canvas.c 

icon  GetHonestX 

this  file 

icon  GetHonestY 

this  file 

icon  Createlcon 

icons. c 

put.msQ 

msQSw.c 

icon  Draw 

this  file 

icon_AddlconToList 

icons. c 

Table  2.1-117: 


icon  Drop  Information. 
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2.1.2.15.20  icon_Select 

This  routine  is  called  when  the  user  clicks  the  right  mouse  button  in  the  drawing  area 
during  icon  selection.  The  routine  selectes  the  clicked  on  icon  and  deselect  all  others.  If  no 
icon  is  clicked  on,  all  icons  are  deselected.  The  selection-specific  menus  are  updated. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

X 

int 

Standard 

1 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

icon  Draw 

this  file 

icon  LocTolcon 

icons.c 

paneLReflectCurrentSelectio 

n 

panel.c 

Table  2.1-118:  icon_Select  Information. 

2.1.2.15.21  icon_Toggle 

This  routine  is  called  when  the  user  clicks  the  middle  button  in  the  drawing  area.  The 
routine  inverts  the  state  of  the  clicked  on  icon.  If  no  icon  was  clicked  on,  the  routine  does 
nothing.  The  selection  state  and  the  selection-specific  menus  are  updated. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

X 

int 

Standard 

1 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

icon  LocTolcon 

this  file 

icon  Draw 

this  file 

paneLReflectCurrentSelectio 

n 

panel.c 

Table  2.I-II9:  icon  Toggle  Information. 

2.1.2.15.22  iconNameStart 

This  routine  is  called  w'hen  the  user  chooses  to  name  an  icon  by  clicking  on  the  icon  with 
the  pencil  cursor.  The  routine  first  finds  the  icon  the  user  intends  to  name.  If  an  icon  w  as 
not  clicked  on,  the  event  is  ignored.  Any  preexisting  icon  name  is  cleared.  The  mapping 
between  an  existing  name  and  the  equipment  table  are  delected.  The  icon  drawing  is 
refreshed.  The  character  handling  module  is  called  to  process  the  character  I/O. 
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Parameters 


Where  Typedef  Declared 


Standard 


Standard 


Calls 

Function 

Where  Described 

canvas  ClearCallbacks 

canvas.c 

icon  LocTolcon 

this  file 

icon  Draw 

this  file 

ICON  NAME  X 


ICON  NAME  Y 


initialize  char  handler 


mode  DisplayHel 


chare 


modes.c 


2.1.2.15.23 


Table  2.1-120:  icon_NameStart  Information, 
icon  NameDone 


This  routine  is  called  to  associate  the  newly  entered  text  with  the  current  icon  as  an  icon 
name.  inputReceived  indicates  whether  the  user  input  any  characters;  equip  is  the  index  of 
equipment  in  the  NOM  shared  memory  table.  If  there  is  no  text,  the  user  is  assumed  to  be 
deleting  an  existing  name.  The  routine  checks  to  make  sure  the  tag  identifies  a  piece  of 
equipment  and  that  no  other  icon  uses  the  identifier.  The  input  session  is  terminated  to 
make  sure  that  input  was  received  from  the  user.  The  name  is  added  to  the  icon  record 
structure,  and  the  icon  is  associated  with  the  correct  equipment  record.  The  resulting  icon 
is  drawn  and  the  user  is  put  back  into  the  mode  for  selecting  an  icon  to  name.  If  this  icon 
was  already  selected,  the  appropriate  selection  change  is  reflected.  The  current  naming  icon 
is  cleared. 


Calls 

Function 

Where  Described 

icon  NameAbort 

icons. c 

icon  NameOn 

this  file 

equip  TrailerToIndex 

equipment. c 

|7 


DISPLAY  ERROR 


icon  TagTolcon  I  this  file 


ut  msa  msasw.c 


terminate  char  handler  char.c 


StrinoCreateCoDv  strinas.c 


icon  Draw  this  file 


paneLReflectCurrentSelectio  panel.c 
n 


Table  2.1-121:  icon  NameDone  Information. 
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2.1.2.15.24  icon_NaineAbort 

This  routine  aborts  the  current  icon  naming  session.  inputReceived  indicates  whether  the 
user  input  any  characters;  eqmp  is  the  index  of  equipment  in  the  NOM  shared  memory 
table.  The  routine  terminates  the  input  session.  If  the  user  was  updating,  the  update  is 
wiped  out. 


1  Calls  1 

Function 

Where  Described 

terminate  char  handler 

char.c 

icon  Draw 

this  file 

Table  2.1-122:  icon_Name Abort  Information. 

2.1.2.15.25  icon_MoveStart 

This  routine  is  called  to  move  an  icon  when  the  user  clicks  in  the  canvas  area  during  icon 
selection  with  the  right  mouse  button.  The  routine  determines  if  the  user  hit  an  icon  and 
changes  the  callbacks  to  handle  the  new  mode.  The  icon  is  blinked,  the  cursor  is  changed 
to  icon  shape,  and  the  real  icon  is  temporarily  deleted  in  order  to  give  the  user  feedback  of 
"dragging". 


1  Parameters  | 

Parameter 

Where  Tvoedef  Declared 

X 

int 

Standard 

1 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

icon  LocTolcon 

this  file 

canvas  ClearCallbacks 

canvas.c 

mode  DisplayHelp 

modes.c 

icon  Blink 

this  file 

XDefineCursor 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

icon.  Erase 

this  file 

Table  2.1-123:  lcon_MoveStart  Information. 

2.1.2.15.26  iconMoveDone 

This  routine  is  called  when  the  user  locales  an  icon  in  the  canvas  to  a  new  position.  'Fh 
new  position  is  recorded  and  icon_SelectOn  is  called  to  restore  normal  selection  mode. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

X 

int 

Standard 

V 

int 

Standard 
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1  Calls  1 

Function 

Where  Described 

icon  GetHonestX 

this  file 

icon  GetHonestY 

this  fiie 

icon  Draw 

this  file 

DISPLAY  ERROR 

icon  AddIconToList 

icons.c 

icon  Selector 

this  file 

Table  2.1*124:  icon  MoveDone  Information. 


2.1.2.15.27  icon  Delete 


This  support  routine  removes  an  icon  from  the  icon  list  by  removing  its  backward  pointer 
from  the  NOM  shared  memory  table  and  freeing  the  icon  memory. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

list 

pointer  to  pointer  to  Iconlfo 

icons.c 

prior 

pointer  to  Iconinfo 

icons.c 

icon 

pointer  to  Iconinfo 

icons.c 

Table  2.1*125:  icon  Delete  Information. 


2,1.2.15.28  icon  GetHonestX 


This  support  routine  returns  the  proper  X  coordinate  for  an  icon  to  be  placed.  The  routine 
accounts  for  grid  snapping  and  ^e  canvas  borders.  If  the  grid  snap  is  on,  the  icon  is 
moved  to  the  nearest  grid  cross  point. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

X 

inf 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

honest 

int 

The  X  coordinate  for  the  icon 
to  be  placed. 

Table  2.1*126:  icon  GetHonestX  Information. 
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2.1.2.15.29  icon  GetHonestY 


This  support  routine  returns  the  proper  Y  coordinate  for  an  icon  to  be  placed.  The  routine 
accounts  for  grid  snapping  and  the  canvas  borders.  If  the  grid  snap  is  on,  the  icon  is 
moved  to  the  nearest  grid  cross  point. 


1  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

1 

int 

Standard 

1  Return  Values  I 

Return  Value 

Meaning 

honest 

int 

The  Y  coordinate  for  the  icon 
to  be  placed 

Table  2.1-127:  icon_GetHonestY  Information. 

2.1.2.15.30  icon_ 

Blink 

This  routine  flashes  the  passed  icon,  leaving  it  in  the  same  selection  state. 

t  Parameters  | 

Parameter 

Where  Tvpedef  Declared 

icon 

pointer  to  Iconinfo 

icons. c 

1  Calls  1 

Function 

Where  Described 

icon  Draw 

this  tile 

Table  2.1-128:  icon  Blink  Information. 


2.1.2.15.31  icon  LocToIcon 


This  routine  returns  a  pointer  to  the  first  icon  found  at  the  passed  location.  A  NULL 
pointer  is  returned  if  no  icon  is  found  at  the  location. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

X 

int 

Standard 

1 

int 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

0 

pointer  to  Iconinfo 

no  icon  is  found  at  the  location 

icon 

pointer  to  Iconinfo 

pointer  to  the  icon  found  at 
the  passed  location 

Table  2.1-129;  icon  Iconinfo  Information. 
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2.1.2.15.32  icon_TagToIcon 

This  routine  returns  a  pointer  to  the  first  icon  identified  by  the  passed  tag.  A  NULL  pointer 
is  returned  if  no  icon  is  found  in  that  location. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

taa 

pointer  to  char 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

pointer  to  Iconinfo 

no  icon  is  found  with  that  tag 

icon 

pointer  to  Iconinfo 

the  icon  identified  by  the  tag 

Calls 

Function 

Where  Described 

StrinqEqual 

strir.q.c 

Table  2.1-1.30:  icon_TagToIcon  Information. 


2.1.2.15.33  icon_CreateIcon 

This  routine  creates  and  initializes  an  icon  with  the  passed  values.  Jt  and  y  hold  the  location 
of  the  icon;  name  holds  the  name  of  the  icon;  equip  is  the  index  into  the  NOM  shared 
memory  table.  The  internal  fields  are  initialized,  Ae  specified  fields  are  set,  and  the 
backwards  pointers  are  placed  in  the  NOM  shared  menwry  table. 


1  Parameters  I 

Parameter 

urmmmmmmm 

Where  Typedef  Declared 

X 

int 

Standard 

1 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

NULL 

pointer  to  Iconinfo 

memory  has  not  been 
allocated  for  the  icon 

icon 

pointer  to  Iconinfo 

the  created  icon 

1  Calls  1 

Function 

Where  Described 

StrinqCreateCopv 

strinq.c 

Table  2.1-131:  icon  Createlcon  Information. 
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2.1.2.15.34  icon  Erase 


This  routine  graphically  erases  the  passed  icon.  The  icon  is  not  deleted  logically.  Any 
overlapping  icons  are  repainted. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

icon 

pointer  to  Iconinfo 

icons.c 

1  Calls  1 

Function 

Where  Described 

XClearArea 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

icon  Draw 

this  file 

Table  2.1-132:  icon  Erase  Information. 


2.1.2.16  states.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  provides  simulator  state  character  for  each  icon. 

2.1.2.16.1  state_GetWidth 

This  routine  returns  the  maximum  length  (in  pixels)  needed  to  hold  a  state  item  menu  entry. 
The  number  of  pixels  used  by  the  longest  en^  are  calculated  and  then  padding  is  added. 


1  Return  Values  j 

Return  Value 

Type 

Meaning 

char_width(normalFont)  * 
maxChars)  + 

2*ITEM  HORZ  PAD 

int 

The  maximum  length  needed 
to  hold  a  state  item  menu 
entry. 

Calls 

Function 

Where  Described 

char  width 

Table  2.1-133:  state  GetWidth  Information. 

2.1.2.16.2  state  lnitMciiu 

This  routine  initializes  the  action  menu  in  the  GUI  panel.  A  constructor  is  created  for  the 
entire  menu.  menuArgs  is  initialized  with  the  passed  constraints.  The  header  label  is 
created  for  the  menu.  A  widget  is  added  for  each  entry  item  in  the  menu.  The  fields  in  the 
entry  are  initialized.  The  widget  ID  of  the  created  menu  is  output  into  widget.  The  routine 
returns  0  if  successful  and  an  eiror  code  if  unsuccessful.  Parameters  are  represented  as 


follows: 

pareni 

-  The  parent  constructor  widget 

spacing 

-  The  spacing  (in  pixels)  from  the  attached  widget 

attach 

-  The  widget  to  which  to  attach  (or  ahgn  next  to) 

width 

-  The  width  of  the  menu 

widget 

--  The  output  action  menu  widget  ID 
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1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

parent 

Widaet 

spadna 

int 

Standard 

attach 

Widqet 

width 

int 

Standard 

widqet 

pointer  to  Widqet 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

int 

Successful 

1  Calls  1 

Function 

Where  Described 

XtCreateManaoedWidoet 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

XtNumber 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-134:  win  InitMenu  Information. 


2.1.2.16.3  state_SetupMenu 

This  routine  completes  the  initialization  of  the  menu  after  the  rest  of  the  environment  has 
stabilized.  This  routine  must  be  called  after  the  initial  current  selection  has  been 
established.  The  routine  returns  0  if  successful  and  an  error  code  if  unsuccesssful. 


I  Return  Values  I 

{Return  Value 

Type 

Meaning 

ErrorCode 

If  0,  then  successful; 
otherwise,  unsuccessful 

returnCode 

ErrorCode 

If  0,  then  successful; 
otherwise,  unsuccessful 

1  Calls  1 

Function 

Where  Described 

activate  Setup 

activate.c 

st  ate_R  ef  lectCu  rre  ntSe  lectio 
n 

states.c 

Table  2.1-135:  win_SetupMenu  Information. 

2.1.2.16.4  staie_ReflectCurrentSelection 

This  routine  reflects  the  state  of  the  currendy  selected  equipment  in  the  menu,  making  the 
menu  context-specific.  One  selected  simulator  for  the  states  menu  is  handled  by  this 
routine.  Information  for  the  passed  simulator's  state  is  found.  The  menu  and  the  specific 
entries  that  are  reachable  from  the  new  current  state  are  activated.  The  X  argument  values 
for  each  item  in  the  state  menu  are  set  up  based  on  the  current  state  of  the  passed 
equipment.  The  routine  returns  0  if  successful  and  an  error  code  if  unsuccessful. 
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1  Return  Values  I 

Return  Value 

Type 

Meaning 

ERRORJNTERNAL 

ErrorCode 

Unsuccessful 

0 

ErrorCode 

Successful 

Calls 

Function 

Where  Described 

icon  GetNextSellcon 

icons.c 

XtSetValues 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

XtNumber 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

icon  GetEquip 

icons.c 

state  StatelDToStateInfo 

this  file 

Table  2.1-136:  win_ReflectCurrentSelection  Information. 
2.1.2.16.5  state_StateSelect 

This  callback  routine  is  called  when  the  user  selects  a  menu  item  from  the  action  menu. 
This  routine  dispatches  to  the  appropriate  subprocessing.  Only  one  selected  menu  context 
is  handled  for  the  states  menu.  An  activation  request  is  sent  for  the  selected  state  and 
resource. 


1  Parameters  | 

Parameter 

Type 

Where  Tvpedef  Declared 

widqet 

Widqet 

iteminfo 

pointer  to  Statelteminfo 

win  menu.c 

Calls 

Function 

Where  Described 

icon  GetNextSellcon 

icons.c 

icon  GetEquip 

icons.c 

DISPLAY  ERROR 

equip  ReflectEquipState 

equipment.c 

activate  DisplavParams 

activate.c 

act  ActionReqPDUFill 

actions.c 

MMP  SendRequest 

MMP.c 

Tabic  2.1-137;  win  ItemSelect  Information. 


2.1.2.16.6  state  StatelDToStateInfo 

This  routine  looks  up  the  Statcltemlnfo  record  for  the  passed  state  ID  and  returns  a  pointer 
to  it.  Zero  is  return^  if  the  lookup  is  successful,  and  a  NULL  pointer  is  returned  if  the 
lookup  is  unsuccessful. 


1  Parameters  | 

Parameter 

Type 

Where  Tvpedef  Declared 

state  ID 

inf 

Standard 
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1  Return  Values  1 

Return  Value 

Meaning 

stateltems[count] 

pointer  to  Statelteminfo 

the  pointer  to  the 

Statelteminfo  record  for  the 
passed  state  10 

0 

pointer  to  Statelteminfo 

unsuccessful 

Table  2.1-138:  state_StateIDToStateInfo  Information. 
2.1.2.16.7  state_GetEquipStateStr 

This  routine  gets  the  string  representing  the  state  of  the  passed  equipment. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

equip 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

itemlnfo->label 

pointer  to  char 

state  of  equip 

«  N 

pointer  to  char 

unsuccessful 

1  Calls  1 

Function 

Where  Described 

state  StatelDToStateInfo 

this  file 

Table  2.1-139:  state_GetEquipStateStr  Information. 


2.1.2.17  paintop.h  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  contains  definitions  for  screen  painting. 

2.1.2.18  xglobals.h  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  includes  X  Windows  toolkit  and  contains  supporting  global  variables  and 
definitions. 

2.1.2.19  xtra.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  provides  original  support  for  converting  "fig"  programs  to  X. 

The  following  utility  routines  are  defined: 

pf_textwidth() 
makegcO 
init  gc() 

CvtStringToFloatO 

CvtlntToFloatO 

fix_converters() 
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2.1.2.20  blink.c  CSU  Description  (/simnet/cmd/nom/gui) 
This  CSU  causes  character  input  cursor  to  blink. 

2.1.2.20.1  turn_on_blinking_cursor 
This  routine  causes  the  input  cursor  to  start  blinking. 


Parameters 


Parameter 


draw_cursor() 


erase  cursor 


Where  Typedef  Declared 


pointer  to  function  returning  Standard 
int 


pointer  to  function  returning  Standard 
int 


int  Standard 


int  Standard 


Standard 


Standard 


Function 


draw  Cursor 


erase  Cursor 


notify  set  itimer  func 


setitimer 


Calls 


Where  Described 


chare 


Table  2.1-140:  turn_on_blinking_cursor  Information. 

2.1.2.20.2  turn_off_blinking_cursor 

This  routine  causes  the  input  cursor  to  stop  blinking. 


Function 


setitimer 


notify  set  itimer  func 


Calls 


Where  Described 


Table  2.1-141:  turn  off  blinking  cursor  Information. 

2.1.2.20.3  blink 

'Fhis  routine  causes  the  cursor  to  blink  and  returns  0  if  successful. 


Return  Values 

Type 

Meaning 

int 

Successful 

Table  2.1'I42:  blink  Information. 
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2.1.2.20.4  inove_biinking_cursor 

This  routine  moves  the  blinking  cursor  to  the  passed  location. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

X 

int 

Standard 

V 

int 

Standard 

Table  2.1-143;  move_blinking_cursor  Information. 


2.1.3  Drawing  Area  Status  Display  CSC  Description 

This  lower-level  CSC  supports  both  color-coded  alarmed  status  display  of  simulator 
symbols  and  letter-coded  SIM  states  display  within  a  simulator  symbol.  This  CSC  also 
supports  a  documentation  line  containing  help  or  error  messages.  The  letter  codes  are  as 
follows: 

P  the  simulator  is  powered  down;  it  has  no  power. 

S  the  simulator  is  shut  down;  it  has  power  but  the  UNIX  operating  system  is 
not  running. 

I  The  simulator  is  idle;  UNIX  is  booted,  but  the  simulation  process  is  not 
running. 

R  The  simulator  is  mnning  a  simulation  process,  but  has  not  been  activated 
into  an  exercise. 

A  The  simulator  is  active;  it  is  part  of  an  exercise. 

A  functional  breakdown  of  this  lower-level  CSC  into  CSUs  is  shown  in  Figure  2. 1.3-1. 


Drawing  Area  Status  Display 
2.1.3 


events.c 

2.1. 3.1 

equipment.c 

2.1. 3.2 


Figure  2.1.3-1:  GUI-Drawing  Area  Status  Display. 
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2. 1.3.1  events.c  CSU  Description  (/simnet/cmd/nom/gui) 


This  CSU  processes  incoming  MMP  event  notifications. 


2. 1.3. 1.1  event_EventDisplay 


This  routine  displays  an  event  to  the  user. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

eventPDU 

pointer  to  MMP  PDUStruct 

Table  2.1-144:  event_EventDisplay  Information. 
2. 1.3. 1.2  event_EventDispatch 

This  routine  processes  the  receipt  of  an  event. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

eventPDU 

pointer  to  MMP  PDUStruct 

Calls 

Function 

Where  Described 

event  EventDisplay 

events.c 

equip  ReflectEquipState 

equipment.c 

Table  2.1-145:  event_EventDispatch  Information. 

2. 1.3. 2  equipment.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  provides  information  about  simulator  equipment  (hosts).  The  file  maintains  and 
accesses  information  from  the  NOM  equipment  table.  Routines  in  this  file  access 
information  about  equipment,  where  equipment  is  represented  by  an  integer  index  into  the 
NOM  shared  memory  table. 

2. 1.3. 2.1  equip_TrailerToIndex 

This  routine  is  used  to  get  the  index  of  a  simulator  matching  the  passed  trailer  and  U'ailer 
element.  The  routine  returns  the  simulator  index  if  successful  and  -1  if  the  simulator  is  not 
found,  or  if  NULL  pointer  is  passed  in. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

trailerloc 

pointer  to  char 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

simulator  rx)t  found  or  NULL 
pointer  passed 

index 

int 

index  of  simulator 
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1  Calls  1 

Function 

Where  Described  I 

equip.  StrinoMatchesTrailer 

equipment.c  1 

Table  2.1>146:  equip_TrailerToIndex  Information. 


2 . 1 . 3 . 2 . 2  equip_StringMatchesTrailer 


This  routine  returns  TRUE  if  the  passed  string  represents  the  passed  trailer  location,  trailer 
is  the  trailer  number;  element  is  the  position  within  the  trailer. 


1  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

strinq 

pointer  to  char 

Standard 

match 

pointer  to  char 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

FALSE 

int 

string  does  not  represent  the 
trailer  loction 

TRUE 

int 

string  represents  the  trailer 
location 

Table  2.1*147:  equip_StringMatchesTrailer  Information. 
2. 1.3. 2. 3  equip_ReflectEquipState 

This  routine  refreshes  the  context-specific  menus  reflecting  the  state  of  the  passed 
equipment 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

equip 

lonq 

Standard 

Calls 

Function 

Where  Described 

icon  Draw 

icons.c 

icon  IsSelected 

icons. c 

paneLReflectCurrentSelectio 

n 

panel.c 

Table  2.1-148:  equip_ReflectEquipState  Information. 
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2. 1.3. 2. 4  equip_GetNumSelected 

This  routine  returns  the  number  of  currently  selected  pieces  of  equipment,  ignoring  selected 
unnamed  icons,  count  is  the  current  count  of  selected  equipment 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

count 

int 

the  number  of  selected  pieces 
of  equipment 

Calls 

Function 

Where  Described 

icon  QetNextSellcon 

icons.c 

icon  GetEouip 

icons.c 

Table  2.1-149:  equip_GetNumSelected  Information. 

2. 1.3. 2. 5  equip_GetFirstSelected 

This  routine  returns  the  index  of  the  first  encountered  selected  equipment  entry  in  the 
equipInfoTable.  If  no  equipment  entry  is  selected,  the  routine  returns  -1. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

index 

int 

the  index  of  the  first  selected 
equipment  entry 

-1 

int 

no  equipment  entry  selected 

Calls 

Function 

Where  Described 

icon  isSelected 

icons.c 

Table  2.1-150:  equip_GetFirstSeIected  Information. 


2.1.4  Auxiliary  Window  Handling  CSC  Description 

This  lower-level  CvSC  enables  these  auxiliary  windows  to  be  generated. 

Console  Terminal,  used  as  a  remote  terminal  window  on  a  selected  simulator. 

Program  Terminal,  used  to  start/stop  a  simulator  process  and  view  its  output. 

Equipment  Status,  used  for  viewing  equipment  status  of  selec:ed  simulators. 

Exercise  Status,  used  for  viewing  exercise  status  of  selected  simulators. 

Outstanding  Events,  used  for  viewing  Outstanding  Events  log. 

A  functional  breakdown  of  this  lower-level  CSC  into  CSUs  is  .shown  in  Figure  2. 1.4-1. 
Additionally,  this  CSC  uses  the  pnnel.c  CSl'  (Section  2,1.1  1) 
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Auxiliary 

Window  Handling 
2.1.4 


exec.c 
2. 1.4.1 

exec.h 
2. 1.4.2 


Figure  2.1.4-1  GUI— Auxiliary  Window  Handling 

2. 1.4.1  exec.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  provides  procedures  for  spawning  subprocesses. 

2. 1.4. 1.1  exec_Comniand 

This  routine  provides  fast  execution  of  child.  The  first  item  in  command  must  be  the 
complete  pathname  of  a  program.  The  routine  returns  the  pid  of  child  if  successful  and  0  if 
unsuccessful.  The  passed  command  string  cmd  is  broken  into  a  program  name  and 
argument  vector,  prog  is  a  pointer  to  the  file  to  be  executed;  argv  are  the  arguments  to  tht 
program;  pid  is  a  process  ID  returned  by  vforkQ. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

cmd 

pointer  to  char 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

pid 

int 

pid  of  the  child 

0 

int 

unsuccessful 

Table  2.1-151:  exec_Comniand  Information. 

2 . 1 .4 . 1 .2  exec_Open  Auxiliary  Window 

This  routine  is  used  to  execute  any  child  processes  which  create  auxiliary  windows  by 
executing  the  process  which  creates  the  auxiliary  window. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

cmd 

pointer  to  char 

Standard 
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1  Calls  1 

Function 

Where  Described 

exec  command 

this  file 

Table  2.1-152;  exec_OpenAuxiliaryWindow  Information. 

2 . 1 . 4 . 1 . 3  exec_Close  Auxiliary  W  indow 
This  routine  closes  the  current  auxiliary  window. 

2. 1.4. 1.4  exec_RemoteTerminal 

This  routine  is  used  to  execute  an  auxiliary  window  containing  a  remote  terminal  to  the 
specified  machine  using  the  specified  channel.  The  machine  is  specified  as  the  machine's 
index  into  the  NOM  shared  memory  table. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

machine 

int 

Standard 

char 

short 

Standard 

1  Calls  1 

Function 

Where  Described 

exec  OpenAuxiliaryWindow 

this  file 

Table  2.1-153:  exec_RemoteTerminal  Information. 

2. 1.4. 1.5  exec_ViewFile 

This  routine  is  executes  an  auxiliary  window  containing  a  "tail"  of  the  specified  file.  The  -e 
option  executes  the  tail  command  within  it.  When  the  t^  is  complete,  the  shell 
automatically  dies.  The  tail  command  used  -160f  as  an  argument  to  print  the  last  160  lines 
of  a  specified  file.  The  'f  signifies  to  print  out  any  newly  appended  lines  of  the  file  while 
the  tail  is  running. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

file 

pointer  to  char 

Standrad 

Calls 

Function 

Where  Described 

exec  OpenAuxiliaryWindow 

this  file 

Table  2.1-154;  exec  ViewFile  Information. 


2. 1.4. 2  exec.h  CSU  Description  (/simnet/emd/nom/gui) 

Phis  is  the  interface  file  for  exec.c. 
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2.1.5  Interface  to  MAP  CSC  Description 

This  lower-level  CSC  formats  and  sends  command  action  requests  to  MAP  and  receives 
SIM  event  information  and  error  reports  from  MAP.  This  CSC  accesses  a  shared  memc^ 
table  for  SIM  status  information  and  uses  Manager-Manager  protocol  to  communicate  with 
MAP. 

A  functional  breakdown  of  this  lower-level  CSC  into  CSUs  is  shown  in  Figure  2. 1.5-1. 
Additionally,  this  CSC  uses  the  CSUs,  events.c,  equipmentc  (Section  2.1.4. 1,  Section 
2.1.4.20). 


Interface  to  MAP 

2.1.5 

gui  ipc.c 

guijpc.h 

2. 1.5.1 

2.1. 5.5 

msgsw.c 

2. 1.5.2 

msgsw.h 

2.1. 5.6 

actions.c 

actions,  h 

2.1.5.3 

2. 1.5.7 

events,  h 

mmp.c 

2.1. 5.8 

2.1.5.4 

equipment.h 

2. 1.5.9 

mmp.h 

2.1.5.10 

Figure  2. 1.5-1  GUI— Interface  to  MAP 

Uses  of  GUI  interfaces  with  MAP: 

The  appropriate  menu  handling  code  uses  supponing  routines  in  actions.c.  to  initiate  action 
requests.  In  turn,  actions.c  uses  supporting  routines  in  mmp.c  to  format  and  send 
Manager-Manager  requests.  Mmp.c  uses  supporting  routines  in  guMpc.c  to  communicate 
with  the  MAP  process. 

If  the  GUI  receives  an  event  pertaining  to  a  depicted  simulator,  the  drawing  of  the 
corresponding  icon  may  be  updated.  Thus,  an  incoming  event  may  cause  a  simulator's 
icon  to  change  color  or  cause  the  status  character  to  change.  The  current  status  and  color  of 
each  icon  is  determined  by  routines  in  equipment.c. 
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2. 1.5.1  guMpc.c  CSU  Description  (simnet  /cmd/nom/gui) 

This  CSU  provides  high-level  interface  IPC  for  the  GUI  process  using  the  BBN-developed 
"YUMM"  library. 

2. 1.5. 1.1  IPCJnitIPC 

This  routine  initializes  the  IPC  fw  the  NOM  graphical  UI.  The  NOM  shared  memory 
structure,  used  during  the  rest  of  inidalization.,  is  attached  and  initialized. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

procName 

pointer  to  char 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

0 

ErrorCode 

Successful 

Table  2.1-155:  IPC_InitIPC  Information. 

2. 1.5. 1.2  IPC_SetupIPC 

This  routine  opens  communications  with  the  server  process.  The  YUMM  usage  is 
initialized.  The  NOM  is  restricted  to  one  GUI  mnning  at  a  time.  If  a  socket  has  this 
process  name  associated  with  it,  it  must  be  deleted  (the  process  probably  died  without 
closing).  The  message  handler  is  registered  to  receive  messages.  The  routine  returns  0  if 
successful  and  an  error  code  if  unsuccessful. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

ERROR_YUMM_IPC 

ErrorCode 

Unsuccessful 

0 

ErrorCode 

Successful 

Calls 

Function 

Where  Described 

LkUpSocket 

Kbipc  in  MCC  CSCI 

CloseSocket 

Hbipc  in  MCC  CSCI 

OpenSocket 

libipc  in  MCC  CSCI 

Tabic  2.1-156:  function  Information. 

2. 1.5. 1. 3  IPCProcessMessagc 

1  his  routine  is  the  YUMM  message  receipt  handler  for  any  protocol  type.  The  routine  is 
invoked  through  the  YUMM  callback  mechanism.  Alarms  are  disabl^  while  messages  are 
being  processed,  then  reenabled  when  finished.  The  message  is  dispatched  to  the  proper 
protocol  handler. 
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1  Parameters  I 

■  Parameter 

Where  Tvpedef  Declared 

int 

Standard 

lenqth 

int 

Standard 

kind 

Iona 

Standard 

info 

Iona 

Standard 

data 

pointer  to  reaister  char 

Standard 

1  Calls  1 

Function 

Where  Described 

MMP  ProcessPDU 

MMP.C 

AlarmsEnabled 

ibipc  in  MCC  CSCI 

Table  2.1-157:  IPC_ProcessMessage  Information. 


2. 1.5. 1.4  IPC_TraceMessage 

This  routine  is  the  handler  used  when  tracing  YUMM  messages.  The  routine  is  invoked 
through  the  YUMM  callback  mechanism.  The  routine  assumes  the  message  is  a  NOM 
MMPPDU. 


1  Parameters  I 

1  Parameter 

Where  Typedef  Declared 

char 

Standaid 

tid 

char 

Standard 

dstSkt 

YUMMSocket 

libipc 

rspSkt 

YUMMSocket 

libipc 

kind 

lonq 

Standard 

lenqth 

int 

Standard 

data 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

MMP  TracePDU 

MMP.C 

Table  2.1-158:  IPC_TraceMessage  Information. 


2. 1.5. 1.5  IPC_SendMessage 

This  routine  sends  data  to  the  specified  process  using  YUMM  IPC.  Each  time  a  message  is 
sent,  a  YUMM  lookup  is  performed  in  order  to  find  any  changes  in  the  sockets.  The 
routine  returns  0  if  successful  and  an  error  code  if  unsuccessful. 


Parameters 


Parameter 


destination 


kind 


lenoth 


data 


inter  to  char 


Where  Tvpedef  Declared 


Stnadard 


Standard 


Standard 


Standard 
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1  Return  Values  I 

Return  Value 

Type 

Meaning 

ERROR_NO_DEST 

ErrorCode 

Unsuccessful 

ERROR_YUMM 

ErrorCode 

Unsuccessful 

0 

ErrorCode 

Successful 

Calls 

Function 

Where  Described 

LkUoSocket 

ibiocin  MCC  CSCI 

SendMsq 

Ibipcin  MCC  CSCI 

Table  2.1>159:  IPC_SendMessage  Information. 

2. 1.5. 1.6  IPC_SendRequest 

This  routine  sends  data  to  the  specified  process  using  YUMM  IPC.  A  reply  is  expected, 
however  the  routine  does  not  Block.  Each  time  a  message  is  sent,  a  YUMM  lookup  is 
performed  in  order  to  find  any  changes  in  the  sockets.  The  routine  returns  0  if  successful 
and  an  error  code  if  unsuccessful. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dest 

pointer  to  char 

Standard 

kind 

lonq 

Standard 

lenqth 

int 

Standard 

data 

pointer  to  char 

Standard 

1  Return  Values  I 

Return  Value 

Meaning 

ERROR_NO_DEST 

ErrorCode 

Unsuccessful 

ERROR_YUMM 

ErrorCode 

Unsuccessful 

0 

ErrorCode 

Successful 

Calls 

Function 

Where  Described 

LkUpSockel 

libipc  in  MCC  CSCI 

Table  2.1-160: 


IPC_SendRequest  Information. 
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2. 1.5. 1.7  IPC_Transact 

This  routine  sends  data  to  the  specified  process  using  YUMM  IPC.  The  routine  Blocks, 
waiting  for  a  response  to  the  message.  Each  time  a  message  is  sent,  a  YUMM  lookup  is 
performed  in  order  to  find  any  changes  in  the  sockets. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dest 

pointer  to  char 

Standard 

kind 

Iona 

Standard 

lenqth 

int 

Standard 

data 

pointer  to  char 

Standard 

rspkind 

pointer  to  int 

Standard 

rspLen 

pointer  to  int 

Standard 

rspData 

pointer  to  char 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

ERROR_NO_DEST 

ErrorCode 

Unsuccessful 

ERROR_YUMM 

ErrorCode 

Unsuccessful 

0 

ErrorCode 

Successful 

Calls 

Function 

Where  Described 

LkUpSocket 

tbipc  in  MCC  CSCI 

Transact 

Rbipc  in  MCC  CSCI 

Table  2.1*161:  IPC_Transact  Information. 
2. 1.5. 1.8  IPC_CleanUp 

This  routine  cleans  up  the  IPC  resources. 


1  Calls  1 

Function 

Where  Described 

YUMMCleanUp 

Nbipc  in  MCC  CSCI 

Table  2.1-162:  IPC_CleanUp  Information. 

2. 1.5. 2  msgsw.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  displays  errors  which  are  reported  by  the  MAP  in  the  message  bar  below  the 
canvas.  Errors  occur  when  the  GUI  can't  get  the  message  to  the  MAP  or  if  the  MAP  itself 
reports  an  error. 

This  CSU  also  displays  help  for  current  canvas  operation. 
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2. 1.5. 2.1  init_insg 

This  routine  initializes  the  message  bar.  The  routine  returns  1  if  successful. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

tool 

Widget 

1  Return  Values  1 

Return  Value 

Meaning 

1 

int 

Successful 

1  Calls  1 

Function 

Where  Described 

XtCreate  M  anaged  Widqet 

public  domain  source  of  X.  version  1 1 .  Release  4  (X1 1 R4) 

XtNumber 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-163:  init^msg  Information. 
2. 1.5. 2. 2  setup_msg 


This  routine  completes  the  initialization  of  the  message  bar  after  realizing  the  widget. 


I  Calls  I 

Function 

Where  Described 

XtSetValues 

public  domain  source  of  X.  version  1 1 .  Release  4  (X1 1 R4) 

XtNumber 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XDefineCursor 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Xt  Window 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-164:  setup_msg  Information. 
2. 1.5. 2. 3  put_msg 

This  routine  puts  a  message  on  the  message  bar. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

format 

pointer  to  char 

Standard 

argl 

int 

Standard 

int 

Standard 

int 

Standard 

arg4 

int 

Standard 

aro5 

int 

Standard 

1  Calls  1 

[Function 

Where  Described 

1  XtSetValues 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-165: 


put  msg  Information. 
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2. 1.5. 2. 4  clear_message 

This  routine  clears  a  message  from  the  message  bar. 


1  Calls  1 

Function 

Where  Described 

XtSetValues 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-166:  clear_inessage  Information. 
2. 1.5. 2. 5  blink_msg 

This  routine  makes  the  message  bar  message  blink. 


1  Calls  1 

Function 

Where  Described 

clear  messaqe 

this  file 

Table  2.1-167:  blink  msg  Information. 

2. 1.5. 3  actions.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  provides  support  for  translating  menu  items  into  Action  requests. 

2. 1.5.3. 1  act_ActionReqPDUFill 

This  routine  fills  in  the  supplied  PDU  with  the  passed  information.  If  no  eventPDU  is 
supplied,  one  is  allocated  and  returned.  The  user  must  free  the  eventPDU  later.  The 
routine  returns  the  MMP_PDUStruct  if  successful  and  0  if  unsuccessful. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

pdu 

pointer  to  MMP  PDUStruct 

resourcelD 

long 

Standard 

actionlD 

long 

Standard 

1  Return  Values  I 

Return  Value 

Meaning 

NULL 

MMP_PDUStruct 

unsuccessful 

actionPDU 

MMP_PDU  Struct 

successful;  the  filled  in  PDU 
structure 

Table  2.1-168:  act  ActionReqPDUFill  Information. 
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2. 1.5. 3. 2  act  SendActionToSelected 


This  routine  generates  an  action  request  for  each  fo  the  selected  pieces  of  equipment,  equip 
is  a  pointer  to  the  equipment  in  the  nomEquipInfo  table;  index  is  the  equipment  index  in  the 
nomEquipInfo  table. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

actionID 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

icon  IsSelected 

icons. c 

act  SendAndCheckReq 

this  file 

Table  2.1-169:  act_SendActionToSelected  Information. 

2. 1.5. 3. 3  act_SendAndCheckReq 

This  routine  is  used  to  send  an  action  request  using  a  Transact.  The  possible  responses  are 
tested  and,  if  necessary,  reported  to  the  user. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dest 

pointer  to  char 

Standard 

request 

pointer  to  MMP  PDUStruct 

response 

pointer  to  MMP  PDUStruct 

Calls 

Function 

Where  Described 

MMP  Transact 

MMP.C 

DISPLAY  ERROR 

Table  2.1-170:  act_SendAndCheckReq  Information. 

2. 1.5. 3. 4  VCR_On 

This  routine  is  not  used  in  the  version  6.0  release. 

2. 1.5. 3. 5  VCR_Off 

This  routine  is  not  used  in  the  version  6.6  release. 

2. 1.5. 3. 6  VCR_RepIay 

This  routine  is  not  used  in  the  version  6.6  release. 


2. 1.5. 4  mmp.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  includes  functions  that  maintain  information  in  the  shared  memory  equipment 
table. 
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2. 1.5.4. 1  MMP_ProcessPDU 

This  routine  is  the  central  handler  for  all  Manager-Manager  PDUs  received  by  the  NOM 
graphical  users  interface.  First  the  transfer  syntax  and  the  internal  PDU  syntax  are 
translated.  The  routine  performs  further  processing  based  on  the  kind  of  PDU  received. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

pdu 

pointer  to  MMP  PDUStaict 

Calls 

Function 

Where  Described 

event  EventDispatch 

events. c 

Table  2.1-171:  MMP  ProcessPDU  Information. 


2. 1.5. 4. 2  MMP_TracePDU 

This  routine  is  not  used  in  the  version  6.6  release. 


2. 1.5. 4. 3  MMP_SendPDU 


This  routine  takes  the  passed  internal  representation  of  the  MMP  PDU,  converts  it  into  the 
transfer  syntax  and  asynchronously  sends  it  to  the  specified  destination  using  the 
appropriate  communication.  This  routine  should  only  be  used  to  send  events  or  other 
PDUs  not  expecting  replies.  The  routine  returns  0  if  successful  and  an  error  code  if 
unsuccessful. 


1  Parameters 

Parameter 

Type 

Where  Typedef  Declared 

destination 

pointer  to  char 

Standard 

pdu 

pointer  to  MMP  PDUStruct 

Return  Values 

Return  Value 

Type 

Meaning 

IPC_SendMessage(destinatio 
n,  mmProtocolKind,  length, 

£du) 

ErrorCode 

If  0,  then  successful; 
otherwise,  unsuccessful 

Calls 

Function 

Where  Described 

IPC  SendMessage 

libipc  in  MCC  CSCI 

Table  2.1-172:  MMP_SendPDU  Information. 
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2. 1.5. 4. 4  MMP_SendRequest 

This  routine  performs  an  asynchronous  transaction  not  waiting  for  the  response  to  an 
originating  MMP  PDU.  The  routine  returns  0  if  successful  and  an  error  code  if 
unsuccessful. 


1  Parameters  | 

Parameter 

Type 

Where  Tvpedef  Declared 

destination 

pointer  to  char 

Standard 

pdu 

pointer  to  MMP  PDUStruct 

1  Return  Values  1 

Return  Value 

Meaning 

IPC_SendRequest(destinatio 
n,  mmProtocolKind,  length, 

£dy] 

ErrorCode 

If  0,  then  successful; 
otherwise,  unsuccessful 

1  Calls  1 

Function 

Where  Described 

IPC  SendRequest 

libipc  in  MCC  CSCI 

Table  2.1-173:  MMP_SendRequest  Information. 

2. 1.5. 4. 5  MMP_Transact 

This  routine  performs  a  synchronous  transaction  waiting  for  the  response  to  an  originating 
MMP  PDU.  The  routine  returns  0  if  successful  and  an  error  code  if  unsuccessful. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

destination 

pointer  to  char 

Standard 

pdu 

pointer  to  MMP  PDUStruct 

response 

pointer  to  MMP  PDUStruct 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

1 

ErrorCode 

unsuccessful 

1PC_T  ransact(destintion, 
mmProtocolkind,  length,  pdu, 
rspKind,  rspLen,  response) 

ErrorCode 

If  0,  then  successful; 
otherwise,  unsuccessful. 

Table  2.1-174:  MMP  Transact  Information. 


2. 1.5.5  gui_ipc.h  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  is  the  interface  file  for  gui.ipc.c.  (See  2. 1.5.1.) 

2. 1.5. 6  msgsw.h  CSU  Description  (/simnet/cmd/nom/gui) 
This  CSU  is  the  interface  file  for  msgsw.c.  (See  2. 1.5. 2.) 
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2. 1.5.7  actions.h  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  is  the  interface  file  for  actions.c  (See  2. 1.5. 3.) 

2. 1.5. 8  events.h  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  is  the  interface  file  for  events.c.  (See  2. 1.3.1.) 

2. 1.5.9  equipment.h  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  is  the  interface  file  for  equipmentc.  (See  2. 1.3.2.) 

2.1.5.10  mmp.h  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  is  the  interface  file  for  mmp.c.  (See  2. 1.5.4.) 

2.1.6  Interface  to  Comms.CSC  Description 

This  lower-level  CSC  formats  and  sends  requests  to  Comms  CSC  to  obtain  a  window  on  a 
remote  SIM  UNIX  shell.  This  CSC  uses  local  monitor  protocol  to  communicate  with 
Comms. 

A  functional  breakdown  of  this  lower-level  CSC  into  CSUs  is  shown  in  Figure  2.1 .6-1. 


Interface  to 
NO&M  Comm. 

2.1.6 


mon_wind.c 

2.1,6.1 


Figure  2.1.6-1:  GUI— Interface  to  Comms. 

2. 1.6.1  mon_wind.c  CSU  Description  (/simnet/cmd/monitor) 

This  CSU  is  used  by  GUI  to  obtain  a  "window"  into  the  shell  spawned  by  a  remote  rover 
process.  While  functionally  relevant  to  GUI,  this  file  is  linked  in  NOM  Comms  process. 

This  CSU  uses  the  simulation  Ethernet  address  of  the  remote  system,  and  the  channel 
number  of  the  remote  shell. 
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Characters  typed  to  mon_wind's  stdin  are  passed  immediately  to  the  remote  shell's  stdin, 
without  modification  or  local  echoing  (there  are  two  exceptions  noted  below).  Characters 
output  by  the  remote  shell  to  its  stdout  or  stderr  are  conveyed  to  mon_wind  and  output  to 
mon_wind's  stdout,  also  without  modification.  Mon_wind  recognizes  two  character 
sequences  as  special  commands  that  it  interprets  rather  than  passing  along  to  the  remote 
shell. 


When  mon_wind  is  used  to  resume  access  to  an  existing,  remote  shell,  the  fido  process 
local  to  mon_wind  may  provide  mon_wind  with  a  transcript  of  the  shell's  recent  output. 
This  session  history  is  recorded  by  fido  for  all  the  remote  shells  it  has  been  involved  with, 
up  to  some  maximum  number  of  shells  and  some  maximum  number  of  characters  per  shell. 


2. 1.6. 1.1  main 


This  routine  is  the  program  entry  point.  The  command  line  arguments  are  parsed.  The 
routine  looks  up  the  YUMM  socket  on  which  fido  is  listening.  A  free  pseudo-tty  for 
communicating  with  fido  is  opened  and  an  attach  message  is  sent  to  fido.  The  user's 
terminal  is  configured  for  raw  I/O.  The  routine  uses  a  small  finite  state  machine  to  watch 
for  escape  sequences  that  terminate  or  suspend  the  tee_in  process.  The  text  is  transferred 
between  the  user's  terminal  and  fido  and  processed. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

arqc 

int 

Standard 

arqv 

pointer  to  array  of  char 

Standard 

1  Calls  1 

Function 

Where  Described 

net  addr  str  to  bin 

libnetif  in  MCC  CSCI  document 

YUMMInit 

libipc  in  MCC  CSCI  document 

YUMMProcess 

libipc  in  MCC  CSCI 

LkUpSocket 

libipc  in  MCC  CSCI 

OpenPseudoTTY 

common.c 

libipc  in  MCC  CSCI 

SetTerminalRaw 

common.c 

FatalSvstemError 

common.c 

RestoreTerminal 

common.c 

Table  2.1-175:  main  Information. 
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2.1.7  Shared  Processing  CSC  Description 

This  lower-level  CSC  contains  definitions  and  procedures  used  by  more  than  one  GUI 
CSC. 

A  functional  breakdown  of  this  lower-level  CSC  into  CSUs  is  shown  in  Figure  2.1. 7-L 


Figure  2.1.7-1  GUI— Shared  Processing 
2. 1.7.1  main.c  CSU  Description  (/simnet/emd/nom/gui) 
This  CSU  contains  the  entry  p  oint  and  main  loop  for  GUI  processing. 
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2. 1.7.1 


main 


This  routine  contains  the  entry  point  to  the  GUI  process.  High  priority  for  the  process  to 
prevent  interruptions.  All  subnwdules  of  the  GUI  are  initialized.  The  stored  site  depiction 
is  loaded.  Communications  are  opened  with  the  server  process  and  the  main  loop  is 
entered.  A  handler  is  set  up  to  process  non-X  events  (asynchronous  interrupts).  The  Xt 
main  loop  is  invoked. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

aroc 

int 

Standard 

arov 

pointer  to  array  of  char 

Standard 

1  Calls  1 

Function 

Where  Described  1 

IPC  InitIPC 

Xtinitialize 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XSetloErrorHandler 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtGetApplicationResources 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

XtNumber 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtDisplav 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtScreen 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

DefaultScreen 

DefauItGC 

tdb  init  cache 

libtdb  in  MCC  CSCI  document 

font  InitFonts 

fonts.c 

color  InitColors 

colors.c 

XtCreteManaaedWidqet 

public  domain  source  of  X,  version  1 1 .  Release  4  (X1 1 R4) 

panel  InitPanel 

panels.c 

canvas  InitCanvas 

canvas.c 

init  msg 

msgsw.c 

panel  SetupPanel 

panel.c 

canvas  SetupCanvas 

canvas.c 

XtSetArt 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtSetValues 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

file  LoadOefaultFile 

file.c 

IPC  Setup  IPC 

XtAddTimeOut 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtAddWorkProc 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtMainLoop 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-176:  main  Information 
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2. 1.7. 1.2  Timeoutinterrupts 

This  routine  sets  the  timeout  interrupts.  The  routine  returns  0  if  succesful. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

int 

Successful 

Calls 

Function 

Where  Described 

XtAddTimeOut 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-177:  Timeoutinterrupts  Information. 
2. 1.7. 1.3  Workinterrupts 

This  routine  sets  the  work  interrupts. 


I  Return  Values  I 

Return  Value 

Type 

Meaning 

FALSE 

int 

Unsuccessful 

Table  2.1-178:  Workinterrupts  Information. 

2. 1.7. 1.4  MainLoop 

This  routine  contains  the  main  loop  of  the  GUI  process.  MainLoop  processes  X  events 
only  if  waiting,  to  prevent  blocking.  Asynchronous  traps  are  allowed  to  get  in  during  a 
window. 


I  Calls  I 

I  Function 

Where  Described 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtAppNexf  Event 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XtDefaultAppContext 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-179:  MainLoop  Information. 


2. 1.7. 1.5  quit 

This  routine  exits  the  GUI  of  the  NOM  and  performs  all  necessary  cleanup.  The  SIMNET 
libraries  are  cleaned  up  and  terminated,  the  top  level  window  is  killed,  and  the  process  is 
exited. 


1  Calls  1 

Function 

Where  Described  1 

IPC  Cleanup 

tdb  terminate 

libtdb  in  MCC  CSCI  document 

XtDestrovWidaet 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

Table  2.1-180:  quit  Information. 
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2. 1.7.2  global.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  contains  declarations  of  global  variables  use  by  GUI. 

2. 1.7.3  strings.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  contains  generic  string  utilities.  The  file  contins  relatively  low-level  string 
manipulation  routines.  While  some  perform  useful  processing,  others  are  defined  for 
clarity  or  to  avoid  common  coding  errors. 

2. 1.7. 3.1  StringCreateCopy 

This  routine  is  a  low  level  library  routine  to  hide  details  while  creating  a  new  copy  of  an 
existing  string. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

strinq 

char 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

new_copy 

char 

A  new  copy  of  string 

Table  2.1-181:  StringCreateCopy  Information. 

2. 1.7. 3. 2  StringEqual 

This  routine  uses  the  standard  routine  strcmp  to  determine  if  two  strings  are  equal. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

stn 

char 

Standard 

Str2 

char 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

strcmp(str1 ,  str2)  ==  0 

int 

If  TRUE,  the  strings  are  equal; 

If  FALSE,  the  strings  are  not 
equal. 

Table  2.1-182:  StringEqual  Information. 
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2. 1.7. 3. 3  StringCopyToken 

This  routine  places  a  copy  of  the  first  word  in  the  passed  buffer  and  returns  a  pointer  to  the 
end  of  that  word  in  the  string. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

strina 

pointer  to  char 

Standard 

word 

pointer  to  char 

Standard 

Return  Value 

NULL _ 

String  +  cur_char 


Return  Values 

_ 

pointer  to  char _ 

pointer  to  char 


Meaning _ 

Unsuccessful _ 

pointer  to  the  end  of  word  in 
the  string _ 


Table  2.1-183:  StringCopyToken  Information. 

2. 1.7. 3. 4  StringContainsWord 

This  routine  returns  TRUE  if  the  passed  word  is  found  as  a  separate  word  in  the  passed 
string,  and  FALSE  if  the  word  is  not  found.  The  routine  assumes  there  are  no  words  in  the 
string  of  greater  than  size  INFINITE. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

string 

pointer  to  char 

Standard 

word 

pointer  to  char 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

int 

word  is  a  separate  word  in  the 
string 

FALSE 

int 

word  is  not  found  in  the  string. 

1  Calls  1 

Function 

Where  Described 

StringCopyToken 

this  file 

StringEgual 

string.c 

Table  2.1-184;  StringContainsWord  Information. 


2. 1.7. 4  fonts.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  creates  and  defines  fonts  used  by  GUI.  The  file  creates  a  set  of  fonts  which  may 
then  be  referenced  in  X  Arg  lists  for  any  widget. 
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2. 1.7. 4.1  font_InitFonts 

This  routine  creates  the  pool  of  fonts  for  subsequent  use  as  XtArgValues.  The  routine 
returns  0  if  successful  and  an  error  code  if  unsuccessful. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

ERROR_NO_FONT 

ErrorCode 

Unsuccessful 

0 

ErrorCode 

Successful 

Calls 

Function 

Where  Described 

XLoadQuervFont 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4'/ 

Table  2.1-185:  font_lnitFonts  Information. 

2. 1.7. 5  colors.c  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  creates  and  defines  colors  used  by  GUI. 

2. 1.7.5. 1  color_InitColors 

This  routine  creates  the  pool  of  colors  for  subsequent  use  as  XtArg  Values.  The  color  cells 
are  allocated  from  the  server  and  the  foreground  and  background  colors  are  determined. 
The  routine  returns  0  if  successful  and  an  error  code  if  unsuccessful. 


I  Return  Values  I 

Return  Value 

Meaning 

ERROR_NO_COLOR 

ErrorCode 

Unsuccessful 

0 

ErrorCode 

Successful 

I  Calls  I 

Function 

Where  Described 

XDefaultColorMap 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

XAIIocNamedColor 

public  domain  source  of  X,  version  1 1 ,  Release  4  (X1 1 R4) 

WhitePixel 

BlackPixel 

Table  2.1-186:  color_InitColors  Information. 

2. 1.7. 6  global.h  CSU  Description  (/simnet/cmd/nom/gui) 
This  CSU  is  the  interface  file  for  global.c.  (See  2. 1.7.2.) 

2. 1.7.7  strings.h  CSU  Description  (/simnet/cmd/nom/gui) 
This  CSU  is  the  interface  file  for  strings.c.  (See  2. 1.7.3.) 
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2. 1.7. 8  fonts.h  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  is  the  interface  file  for  fonts.c.  (See  2. 1.7 .4.) 

2. 1.7. 9  colors.h  CSU  Description  (/simnet/cmd/nom/gui) 

This  CSU  is  the  interface  file  for  colors.c.  (See  2. 1.7.5.) 

2.2  MAP  (Management  Applications  Process)  CSC  Description 

A  separate  CSC,  called  the  management  application  process  (MAP),  is  responsible  for 
actu^ly  performing  the  management  tasks  of  the  NOM. 

This  process  normally  monitors  the  state  of  running  simulators  and  listens  for  any  error 
reports  which  occur  on  simulators  or  MCCs,  which  it  then  logs  on  disk.  MAP  also 
monitors  status  PDUs  for  events  and  logs  them  into  an  Events  Log  on  disk.  Events  which 
it  determines  are  important  are  immediately  communicated  to  GUI.  All  other  information 
about  simulators,  along  with  certain  NOM  parameters,  are  maintained  by  the  MAP  only  in 
shared  memory  for  access  by  GUI. 

MAP  also  accepts  requests  from  the  user  interface  to  perform  management  tasks.  Upon 
receiving  a  request,  the  MAP  may  coordinate  the  efforts  of  other  NOM  processes  in 
addition  to  performing  its  own  processing.  The  MAP  communicates  with  the  simulators 
via  the  SIMNET  network  for  state  information,  interfaces  to  the  power  controller  (using  the 
separate  lamplighter  interface)  through  shared  menrory  to  determine  the  overall  state  of  the 
simulator,  and  uses  the  communications  subsystem  to  change  simulator  states. 

Generally,  the  MAP  will  send  an  immediate  acknowledgement  to  GUI  when  it  receives  a 
request  and  a  subsequent  event  notifying  the  user  interface  if  the  request  ultimately  fails. 

MAP  has  the  major  responsibility  for  maintaining  shared  memory.  It  initializes  current 
threshold  values,  which  can  be  updated  by  GUI,  for  equipment  status  values  that  generate 
alarms,  and  manages  the  simulator  attributes  table  contained  in  shared  memory. 

Events: 

MAP  maintains  a  system- wide  events  log  on  disk,  which  a  technician  may  display.  When 
MAP  determines  an  event  to  be  'important,'  it  sets  an  alarm  bit  in  the  appropriate  shared 
memory  field  for  the  selected  SIM;  this  causes  a  color-coded  alarmed  display.  Any  of  the 
following  events  will  set  the  alarm  bit. 

•  Preset  equipment  threshold  values  are  exceeded  by  current  equipment  conditions; 

•  SIM  error  report; 

•  power  problem; 

•  A  user  request  whose  failure  has  been  detected  by  MAP. 

Equipment  and  power  problems  can  be  self-correcting;  when  corrected,  MAP  resets  the 
alarm  bit,  causing  the  SIM  alarmed  state  to  clear.  Problems  associated  with  the  other 
conditions  above,  are  not  self-correcting;  a  SIM  alarmed  display  can  only  be  cleared  at  the 
user  interface.  Alarmed  events  that  self-correct  remain  in  the  outstanding  events  log  until 
acknowledged  by  GUI. 
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A  fully  configured  MAP  implements  the  following  management  commands: 

•  Activate/Deactivate,  which  enters/removes  a  simulation  ftom  an  exercise; 

•  Shutdown,  which  shuts  down  the  SIM  application  and  its  UNIX  operating 
system; 

•  Start/Stop,  which  starts/stops  a  simulation  application  process; 

•  Powerup/powerdown,  which  controls  power  to  the  simulator. 


A  functional  breakdown  of  MAP  CSC  is  illustrated  in  Figure  2.2-1. 


Figure  2.2-1:  MAP  CSC  Structure. 


2.2.1  Manage  Simulators  CSC  Description 

This  lower-level  CSC  creates  and  sends  GUI-requested  commands  on  simulators.  These 
commands  are:  powerup/powerdown,  shutdown,  and  start/stop  a  simulator  process. 

This  CSC  also  monitors  simulators.  From  a  shared  memory  table,  it  accesses  power-related 
events  PDUs  placed  there  periodically  by  the  Lamplighter  Interface,  and  simulator 
equipment-related  events  placed  there  periodically  by  NOM-SIM  communications.  It  also 
monitors  SIM  and  MCC  hosts  for  error  reports.  This  CSC  maintains  error  and  event  logs 
on  disk,  which  are  viewable  by  GUI. 

A  functional  breakdown  of  this  lower-level  CSC  into  CSUs  is  shown  in  Figure  2.2. 1-1. 


Manage 

Simulators 


equipment.c 

2.2.1 .1 

equipment.h 

2.2.1 .2 


Figure  2.2. 1-1:  MAP— Manage  Simulators. 

2.2. 1.1  equipment.c  CSU  Description  (/simnet/cmd/nom/mini) 

This  CSU  is  devoted  to  performing  host-related  management.  This  includes  tasks  such  as 
powering  up  or  down  the  host,  halting  the  operating  system,  and  monitoring  the  equipment 
status  (temperatures  and  voltages).  This  CSU  includes  functions  that  maintain  information 
in  the  shar^  memory  equipment  table. 
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2. 2. 1.1.1  Equip_GetTraiIerLoc 

This  routine  returns  the  trailer  location  of  the  passed  equipnient  from  the  Equipment  Table. 


1  Parameters  I 

■  Parameter 

Type 

Where  Typedef  Declared 

1  index 

int 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

sEquiomentTable  [index], info 
->trailerLoc 

pointer  to  char 

The  trailer  location  from  the 
Equipment  Table. 

Table  2.2-1:  Equip_GetTrailerLoc  Information. 


2.2. 1.1.2  Equip_LogEvent 


This  routine  formates  the  passed  event  text  for  this  equipment  and  logs  it.  The  routine  does 
NOT  add  the  event  to  the  list  of  outstanding  events.  The  formatted  event  and  log  time  are 
provided  as  output  parameters. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

index 

int 

Standard 

eventText 

pointer  to  char 

Standard 

formEvent 

pointer  to  pointer  to  char 

Standard 

time 

pointer  to  pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

EM  LogEventText 

events, c 

Table  2.2-2:  Equip  LogEvent  Information. 

2. 2. 1.1. 3  Equip_ProcessEvent 

This  routine  processes  an  event  received  for  this  equipment.  The  event  is  an  MM  event, 
identified  by  a  code.  The  event  may  have  been  generated  internally  by  this  process  or 
received  from  another  process  or  the  CMC.  The  event  is  logged  and  forwarded. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

index 

int 

Standard 

event  ID 

int 

Standard 
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1  Calls  1 

Function 

Where  Described 

UserReport 

Equip  AddEvent 

equipment. c 

EM  EventlsActFail 

events.c 

EM  SendNewStateEvent 

events. c 

EM  EventlsPower 

Table  2.2-3  Equip_ProcessEvent  Information. 

2. 2. 1.1. 4  Event_AddEvent 

This  routine  logs  an  event  and  adds  it  to  the  list  of  outstanding  events.  The  event  is  logged 
and  the  formatted  event  and  log  time  are  obtained  as  output  parameters.  A  new  event 
record  is  created  and  initialized.  The  new  event  is  added  to  the  current  event  list. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

index 

int 

Standard 

eventID 

int 

Standard 

Calls 

Function 

Where  Described 

Equip  LoqEvent 

equipment. c 

Table  2.2-4:  Equip_AddEvent  Information. 


2.2.1.1.15  Equip_ErrorReceived 

This  routine  adds  an  event  record  from  an  ErrorReport  PDU. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Deciared 

index 

int 

Standard 

Calls 

Function 

Where  Described 

Equip_.AddEvent 

equipment.c 

Table  2.2-5:  Equip_ErrorReceived  Information. 
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2.2.1.1.16  Equip_ClearEvents 

This  routine  clears  any  current  alarm  state  in  the  list  of  current  events. 


1  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

index 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

EM  SendNewStateEvent 

events.c 

Equip.  LoaEvent 

equipments 

Table  2.2-6:  Equip_ClearEvents  Information. 
2.2.1.1.17  Equip_EventStatus 

This  routine  outputs  the  list  of  current  events  into  the  passed  file. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

index 

int 

Standard 

file 

pointer  to  FILE 

Table  2.2-7  Equip_EventStatus  Information. 

2.2.1.1.18  Equip_Intialize 

This  routine  is  called  to  initialize  INSTANCE  variables.  strAddr  is  a  string  version  of  the 
Ethernet  address;  trailerLoc  is  a  string  version  of  the  floor  location.  The  routine  first 
determines  the  kind  of  equioment.  The  Equipment  Table  fields  are  initialized,  and  the  U1  is 
alerted  of  the  new  status. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

index 

int 

Standard 

site 

int 

Standard 

host 

int 

Standard 

StrAddr 

pointer  to  char 

Standard 

trailerLoc 

pointer  to  char 

Standard 

lampAddr 

int 

Standard 

vehicleType 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

Sim  Initialize 

simulators.c 

EM  SendNewStateEvent 

events.c 

net  addr  str  to  bin 

libnetif  in  MCC  CSCI  document 

Table  2.2-8:  Equip_Initialize  Information. 
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2.2.1.1.19  Equip_UpdateState 

This  routine  is  periodically  called  to  update  monitored  state  variables.  Depending  upon  the 
type  of  PDUs  received  in  the  past  interval  and  the  internal  NOM  shared  memcwy  states,  the 
operating  state  of  the  simulator  is  updated.  A  monitoring  interval  is  the  longest  protocol 
interval  used  divided  by  EQUIP_PEEK_AHEAD. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

index 

int 

Standard 

Calls 

Function 

Where  Described 

EM  SendNewStateEvent 

events.c 

Table  2.2-9:  Equip_UpdateState  Information. 
2.2.1.1.20  Equi p_Equi pmentReceived 

This  routine  is  called  when  an  equipment  status  PDU  is  received. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

index 

int 

Standard 

pdu 

pointer  to  ManaqementPDU 

Calls 

Function 

Where  Described 

Equip.  AddEvent 

equipment. c 

EM  SendNewStateEvent 

events.c 

Table  2.2-10:  Equip_EquipmentReceived  Information. 
2.2.1.1.21  Equip_EquipmentStatus 
This  routine  prints  out  the  current  equipment  status. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

index 

int 

Standard 

file 

pointer  to  FILE 

Table  2.2-11:  Equip_EquipmentStatus  Information. 
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2.2.1.1.22  Equi p_VehicleStatusReceived 
This  routine  is  called  when  a  VehicleStatus  PDU  is  received. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

index 

int 

Standard 

pdu 

pointer  to  DataCollectionPDU 

Calls 

Function 

Where  Described 

Sim  VehicleStatus  Received 

simulators 

Table  2.2-12:  Equip_VehicleStatusReceived  Information. 
2.2.1.1.23  Equip_ExerciseStatus 

This  routine  prints  out  the  current  exercise  status. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

index 

int 

Standard 

file 

pointer  to  FILE 

1  Calls  1 

Function 

Where  Described 

Sim  ExerciseStatus 

simulators 

Table  2.2-13:  Equip_ExerciseStatus  Information. 
2.2.1.1.24  Equip_Shutdown 

This  routine  shuts  down  the  host. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

index 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

SendToRemoteHost 

rsend.c 

Table  2.2-14:  Equip_Sbutdown  Information. 
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2.2.1.1.25  EquipmentParseFile 

This  routine  parses  the  MCXT-pars  file  and  creates  instances  for  all  the  equipment  and  their 
simulators  registered  in  the  file. 


1  Calls  1 

Function 

Where  Described 

Equipment  initialize 

this  file 

Table  2.2-15:  EquipmentParseFile  Information. 

2.2.1.1.26  EquipmentInitTerrain 

This  routine  initializes  the  terrain  data  base  library  (libtdb).  The  library  is  defaulted  in  the 
MCC-pars  file,  however  it  may  be  overridden  through  the  command-line  switch. 


t  Calls  i 

Function 

Where  Described 

tdb  init  cache 

libtdb  in  MCC  CSCI  document 

tdb  qet  tdb  name 

libtdb  in  MCC  CSCI  document 

Table  2.2-16:  EquipmentInitTerrain  Information. 

2.2.1.1.27  Equipmentinitialize 

This  routine  initializes  the  equipment  module.  The  lookup  table  for  host  indices  is 
initialized,  the  MCC-pars  file  is  read  and  the  appropriate  equipment  records  are  recorded, 
and  the  terrain  database  is  initialized. 


1  Calls  1 

Function 

Where  Described 

EquipmentParseFile 

this  file 

EquipmentInitTerrain 

this  file 

Table  2.2-17:  Equipmentinitialize  Information. 
2.2.1.1.28  EquipmentDoMonitor 

This  routirse  monitors  the  receipt  of  Equipment  Status  reports  and  Vehicle  Appearance 
Packets.  Outstanding  powerdowns  are  retried  from  this  routine. 


1  Calls  1 

Function 

Where  Described 

Equip  UpdateState 

this  file 

EquipmentRetrvPowerdown 

this  file 

Table  2.2-18:  EquipmentDoMonitor  Information. 
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2.2.1.1.29  TrailerLocToIndex 

This  routine  is  used  to  obtain  the  instance  of  a  simulator  matching  the  passed  trailer  and 
trailer  element 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

pair 

pointer  to  char 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning  | 

index 

int 

-1 

int 

Unsuccessful  I 

1  Calls  1 

Function 

Where  Described 

Sim  Trailer 

simulators.c 

Table  2.2>19:  TrailerLocToIndex  Information. 
2.2.1.1.30  EquipmentRetryPowerdown 

This  routine  attempts  to  powerdown  any  remaining  simulatorts.  The  routine  iterates 
through  the  sPowerdownEquiopment  array  searching  for  simulators  waiting  for 
powerdown.  A  non-zero  entry  impleies  the  corresponding  simulator  in  the  nominfo 
Equipment  Table  should  be  powered  down. 


1  Calls  1 

Function 

Where  Described 

Equip  ProcessEvent 

this  file 

Table  2.2-20:  EquipmentRetryPowerdown  Information. 
2.2.1.1.31  EquipmentPowerdown 

This  routine  coordinates  the  multi-stage  powerdown  of  multiple  simulators. 


1  Parameters  | 

{Parameter 

Type 

Where  Typedef  Declared 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

Equip  Shutdown 

this  file 

Table  2.2-21:  function  Information. 


2.2. 1.2  equipment.h  CSU  Description  (/simnet/cmd/nom/mini) 
This  CSU  is  the  interface  file  for  equipment.c. 
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2.2.2  Manage  Simulations  CSC  Description 

This  lower-level  CSC  creates  and  sends  GUI-requested  commands  on  simulations.  Such 
commands  consists  of  activating/deactivating  a  simulation  exercise.  This  CSC  also 
monitors  the  state  of  a  SIM  application,  and  infers  exercise  status  from  vehicle  state 
information  provided  by  the  Interface  to  the  SIMNET  Network  ( Section  2.2.8,  below)  and 
stores  it  in  the  shared  memory  table. 

A  functional  breakdown  of  this  lower-level  CSC  into  CSUs  is  shown  in  Figure  2.2.2- 1. 


Manage 

Simulations 

2.2.2 


simulators.c 

2.2.2.1 

simulators.h 

2.2.22 


Figure  2.2.2-1:  MAP-Manage  Simulations 

2. 2. 2.1  simulators.c  CSU  Description  (/simnet/cmd/nom/mini) 

This  CSU  is  devoted  to  performing  simulation  software-related  management.  This  module 
is  the  one  which  "speaks"  the  SIMNET  simulation  protocol,  for  monitoring  simulation 
attributes,  generating  appropriate  alarms,  and  issuing  simulator  software  commands  (to 
activate  or  deactivate,  using  Simulation  protocol). 

2.2.2. 1.1  Sim_Initialize 

This  routine  initializes  the  simulator  variables.  Some  of  the  variables  are  set  based  on  the 
passed  parameters,  while  the  user-initializable  attributes  are  set  to  their  default  values. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

index 

int 

Standard 

trailerLoc 

pointer  to  char 

Standard 

info 

pointer  to  NomEquipInfo 

simulators.c 

Table  2.2-22:  Sim  Initialize  Information. 
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2. 2. 2. 1.2  Sim_TrailerMatch 

This  routine  returns  TRUE  if  the  passed  string  represents  the  trailer  ID  of  the  vehicle. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

index 

int 

Standard 

pair 

pointer  to  char 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

int 

pa/r  represents  the  trailer  ID 

FALSE 

int 

pair  does  not  represent  the 
trailer  ID 

Table  2.2-23:  Sim_TrailerMatch  Information. 
2.2.2. 1.3  Sim_ExerciseStatus 

This  routine  prints  out  the  simulator's  exercise  status. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

index 

int 

Standard 

file 

pointer  to  FILE 

Table  2.2-24:  Sim  ExerciseStatus  Information. 


2. 2. 2. 1.4  Sim_VehicleStatusReceived 

This  routine  is  called  when  a  Vehicle  Status  PDU  is  received  in  order  to  update  the 
vehicle's  attributes. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

index 

int 

Standard 

pdu 

pointer  to  DataCollectionPDU 

Table  2.2-25:  Sim  VehicleStatusReceived  Information. 
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2. 2. 2. 1.5  Sim_SetActivateArgs 

This  routine  interacts  directly  with  the  user  to  reset  the  default  activate  arguments.  The  user 
is  prompted  with  the  default  for  each  of  the  arguments.  The  routine  checks  for  validity  of 
any  input  The  default  will  only  be  overwritten  if  the  user  inputs  a  value. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

index 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

UserConfirm 

UserPrompt 

UserGetInput 

tdb  giv  XV  get  utm 

libtdb  in  MCC  CSCI 

libtdb  in  MCC  CSCI 

tdb  p  on  database 

libtdb  in  MCC  CSCI 

Sim  SetActivateArgs 

simulators.c 

Table  2.2-26:  Sim_SetActivateArgs  Information. 
2.2.2. 1.6  Sim  GetActivateDefauits 


This  routine  returns  the  default  values  used  for  activation. 


[  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

index 

int 

Standard 

rsp 

pointer  to  MMP  PDUData 

1  Calls  1 

Function 

Where  Described 

Sim  PrepActivatePDU 

simulators.c 

Table  2.2-27:  Sim_GetAcUvateDefaults  Information. 

2 . 2 . 2 . 1 . 7  Sim_Acti  vateF  romRequest 

This  routine  attempts  to  activate  this  simulator  using  parameters  passed  in  from  an  MM 
protocol  request. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

index 

int 

Standard 

mmPdu 

pointer  to  MMP  PDUStruct 

Calls 

Function 

Where  Described 

AssocSendT  ransact 

libassoc  in  MCC  CSCI  document 

Table  2.2-28:  Sim_ActivateFromRequest  Information. 
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2. 2. 2. 1.8  Siin_PrepActivatePDU 

This  routine  fills  the  planned  activation  values  into  the  passed  PDU  for  this  simulator.  This 
routine  is  used  both  for  sending  PDUs  to  the  simulator  and  for  returning  default  values  to 
the  GUI.  The  typical  unit  information,  the  generic  status  fields,  the  ground  vehicle  specific 
status  field,  the  vehicle  specific  information,  the  constant  fields,  and  the  user  settable  fields 
are  filled  in. 


I  Parameters  | 

Parameter 

Where  Typedef  Declared 

index 

int 

Standard 

pdu 

pointer  to  SimulationPOU 

Table  2.2-29:  Sini_PrepActivatePDU  Information. 
2. 2. 2. 1.9  Sim_Activate 

This  routine  attempts  to  activate  this  simulator. 


1  Parameters  | 

Parameter 

Where  Tvpedef  Declared 

index 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

AssocSendTransact 

libassoc  in  MCC  CSCI  document 

AssocError 

libassoc  in  MCC  CSCI  document 

Table  2.2-30  Sim_Activate  Information. 
2.2.2.1.10  Sim_Deactivate 
This  routine  attempts  to  deactivate  this  simulator. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

index 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

AssocSendT  ransact 

libassoc  in  MCC  CSCI  document 

AssocError 

libassoc  in  MCC  CSCI  document 

Table  2.2-31  Sim_Deactivate  Information. 
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2.2.2.1.11  Sim_Start 

This  routine  attempts  to  run  the  simulator  application. 


1  Parameters  I 

Parameter 

Where  Tvnedef  Declared 

index 

int 

Standard 

Calls 

Function 

Where  Described 

SendToRemoteShell 

rsend.c 

Table  2.2-32:  Siin_Start  Information. 
2.2.2.1.12  Sim_Stop 

This  routine  attempts  to  stop  the  simulator  application. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

ind^x 

int 

Standard 

Calls 

Function 

Where  Described 

SendToRemoteShell 

rsend.c 

Table  2.2-33  Sim^Stop  Information. 


2.2.2.1.13  Sim_NoActivateRsp 

This  routine  is  a  callback  passed  to  the  Association  layer,  and  is  called  when  there  is  no 
sign  of  an  activate  response  from  the  requested  simulator. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

data 

pointer  to  char 

Standard 

lenqth 

long  int 

Standard 

respondent 

pointer  to  SimulationAddress 

param 

pointer  to  long  int 

Standard 

Calls 

Function 

Where  Described 

Equip  ProcessEvent 

this  file 

Table  2.2-34:  Sim_NoActivateRsp  Information. 
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2.2.2.1.14  Siin_N9DeactivateRsp 


This  routine  is  a  callback  passed  to  the  Association  layer,  and  is  called  when  there  is  no 
sign  of  an  deactivate  response  from  the  requested  simulator. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

data 

pointer  to  char 

Standard 

lenath 

lonq  int 

Standard 

respondent 

pointer  to  SimulationAddress 

param 

pointer  to  lonq  int 

Standard 

1  Calls  1 

Function 

Where  Described 

Equip  ProcessEvent 

this  file 

Table  2.2-35:  Sim_NoDeactivateRsp  Information. 
2.2.2.1.15  Sim_GotActivateRsp 

This  routine  is  a  callback  passed  to  the  Association  layer,  and  is  called  when  an  activate 
response  is  returned  from  the  requested  simulator. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

data 

pointer  to  char 

Standard 

lenqth 

lonq  int 

Standard 

respondent 

pointer  to  SimulationAddress 

param 

pointer  to  lonq  int 

Standard 

Calls 

Function 

Where  Described 

Equip  ProcessEvent 

this  file 

Table  2.2-36:  Sim  GotActivateRsp  Information. 
2.2.2.1.16  Sim^GotDeactivateRsp 

This  routine  is  a  callback  passed  to  the  Association  layer,  and  is  called  when  a  deactivate 
response  is  returned  from  the  requested  simulator. 


1  Parameters  | 

Parameter 

Where  Tvpedef  Declared 

data 

pointer  to  char 

Standard 

lenqth 

lonq  int 

Standard 

respondent 

pointer  to  SimulationAddress 

param 

pointer  to  lonq  int 

Standard 

1  Calls  1 

Function 

Where  Described 

Equip,  ProcessEvent 

this  file 

Table  2.2-37:  Sim_GotDeactivateRsp  Information. 
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1.2. 1.2  simulators.h  CSU  Description  (/simnet/cmd/nom/mini) 

This  CSU  is  the  interface  file  for  simulators.c. 

2.2.3  Shared  Processing  CSC  Description 

This  lower-level  CSC  contains  definitions  and  procedures  used  by  more  than  one  MAP 
CSC. 

A  functional  breakdown  of  this  lower-level  CSC  into  CSUs  is  shown  in  Figure  2.2.3-1. 


Shared 

Processing 

2.2.3 


main.c 

2.2.3.1 

globals.c 

2.2.3.2 

globals.h 

2.2.3.3 

strings.c 

2.2.3.4 

strings.h 

2.2.3.5 

Figure  2.2. 3-1:  MAP— Shared  Processing 


2.2.3. 1  main.c  CSU  Description  (/simnet/cmd/nom/mini) 

This  CSU  contains  the  entry  point  and  main  loop  for  MAP  process. 
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2.2.3. 1.1  main 

This  routine  is  the  Management  Application  Process  program  entry  point.  The  routine 
provides  initial  values  of  globals,  which  may  be  overridden  by  command  line  of  parameters 
files.  The  command  line  is  processed,  performing  any  initial  commands.  The  modules  are 
initial’ •’ed.  Signals  are  set  up,  in  order  for  termination  to  cause  cleanup.  Crash  signals  are 
set  up  for  cleanup  and  core  dump.  The  initial  user  input  is  prompted,  and  the  master 
polling  loop  is  started. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

argc 

int 

Standard 

arcjv 

pointer  to  pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described  1 

IPC  InitIPC 

Globalsinitialize 

Qiobais.c 

MMP  Initialize 

ProcessCommandLine 

InitAlarms 

AlarmsEnabled 

Sbipc.a  in  MCC  CSCI 

ORN  InstallSpecialExceptions 

EM  InitEM 

events. c 

Equipmentinitialize 

equipment.c 

Networkinitialize 

pduio.c 

Ullnitialize 

ttv  ui.c 

Ul  MasterPoll 

ttv  ui.c 

Table  2.2*38:  main  Information. 

2. 2. 3. 2  globals.c  CSU  Description  (/simnet/cmd/nom/mini) 

This  CSU  contains  global  variables  for  inter-module  communications. 

2. 2. 3. 2.1  Globalsinitialize 

This  routine  sets  variable  globals  to  their  initial  values,  if  necessary. 

2. 2. 3. 2. 2  GlobalsCleanUp 

This  routine  cleans  up  the  globals,  printing  status  information. 

2. 2. 3. 3  globals.h  CSU  Description  (/simnet/cmd/nom/mini) 

This  CSl  1  contains  declarations  for  globals.c. 

2. 2. 3. 4  strings.c  CSU  Description  (/simnet/cmd/nom/mini) 

This  CSU  contains  generic  string  utilities.  The  file  contins  relatively  low-level  string 
manipulation  routines.  While  some  perform  useful  processing,  others  are  defined  for 
clarity  or  to  avoid  common  coding  errors. 
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This  routine  is  a  low  level  library  routine  to  hide  details  while  creating  a  new  copy  of  an 
existing  string. 


Paramciters 


Parameter 


strin 


ion 


Where  Tyoedef  Declared 


Standard 


Return  Values 


Return  Value 


new_copy 


Meanin 


A  new  copy  of  string 


Table  2.2*39  StringCreateCopy  Information. 

2. 2. 3. 4. 2  StringEqual 

This  routine  uses  the  standard  routine  strcmp  to  determine  if  two  strings  are  equal. 


Parameters 


Parameter 


stn 


str2 


Where  Typedef  Declared 


Standard 


Standard 


Return  Values 

Return  Value 

Type 

Meaning 

strcmp(str1 ,  str2)  ==  0 

int 

If  TRUE,  the  strings  are  equal: 

If  FALSE,  the  strings  are  not 
equal. 

Table  2.2*40:  StringEqual  Information. 

2. 2. 3. 4. 3  StringCopyToken 

This  routine  places  a  copy  of  the  first  word  in  the  passed  buffer  and  returns  a  pointer  to  the 
end  of  that  word  in  the  string. 


Parameters 


Parameter 


strin 


word 


inter  to  char 


inter  to  char 


Where  Typedef  Declared 


Standard 


Standard 


Return  Values 

Return  Value 

Type 

Meaning 

NULL 

pointer  to  char 

Unsuccessful 

String  +  cur_char 

pointer  to  char 

pointer  to  the  end  of  word  in 
the  string 

Table  2.2*41:  StringCopyToken  Information. 
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2. 2. 3. 4. 4  StringContainsWord 

This  routine  returns  TRUE  if  the  passed  word  is  found  as  a  separate  word  in  the  passed 
string,  and  FALSE  if  the  word  is  not  found.  The  routine  assumes  there  are  no  words  in  the 
string  of  greater  than  size  INFINITE. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

strina 

pointer  to  char 

Standard 

word 

pointer  to  char 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

TRUE 

int 

word  is  a  separate  word  in  the 
Strinq 

FALSE 

int 

word  is  not  found  in  the  string. 

1  Calls  1 

Function 

Where  Described 

StrinaCoDvToken 

strinqs.c 

StrinqEqual 

strinqs.c 

Table  2.2>42:  StringContainsWord  Information. 


2. 2. 3. 5  strings.h  CSU  Description  (/simnet/cmd/nom/mini) 

This  CSU  displays  help  for  current  canvas  operation  (or  error  messages  when  appropriate). 
2.2.4  Important  Events  CSC  Description 

This  lower-level  CSC  determines  which  power-  and  equipment-related  events  should  be 
treated  as  important  events  for  notifying  GUI.  In  making  the  determination  which 
equipment-related  events  are  outstanding,  this  CSC  uses  threshold  values  set  by  a 
technician.  Also  treated  as  an  outstanding  event  is  the  lack  of  a  SIM  heartbeat,  for  which 
the  NOM  polls  each  SIM  periodically.  A  monitor  Response  PDU  from  a  SIM  is  the 
"heartbeat"  that  the  NOM  listens  for  in  order  to  determine  whether  a  SIM  is  running  and 
connected  to  the  network.  The  protocol  for  this  communication  function  is  the  monitor 
protocol  (refer  to  Section  2.2.5,  "Interface  to  Comms.CSC  Description.") 

This  CSC  also  formats  error  and  outstanding  event  reports  for  sending  to  GUI. 

A  functional  breakdown  of  this  lower-level  CSC  into  CSUs  is  shown  in  Figure  2.2.4- 1. 
Additionally,  this  CSC  references  the  CSUs,  equipment.c  and  equip- '  -nt.h,  (Section 
2.2. 1.1  and  Section  2.2. 1.2). 
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Important  Events 
2.2.4 


events.c 

2.2.4.1 

events.h 

2.2.42 


Figure  2.2.4-1:  MAP>-Iinportant  Events 

2.2.4. 1  events.c  CSU  Description  (/simnet/cmd/nom/mini) 

This  CSU  provides  support  for  formatting  and  sending  alarmed  SIM  state  information  to 
GUI.  Notification  of  events  is  received,  events  are  logged  or  consolidated,  subscription 
requests  are  received,  and  events  are  forwarded  to  subscribers. 

2.2.4. 1.1  EMJnitEM 

This  routine  initializes  the  EM  module. 


1  Calls  1 

Function 

Where  Described 

EM  SubscriptionReceive 

this  file 

Table  2.2-43  EM_InitEM  Information. 

2. 2. 4. 1.2  EM_EventIsActFail 

This  routine  returns  whether  the  passed  event  indicates  a  request  has  failed. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

event 

Event 

events.h 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

eventjable 

[EM_iEventGetlndex(event)]. 

actPail 

int 

Whether  the  request  has 
failed 

Calls 

Function 

Where  Described 

EM  lEventGetlndex 

this  file 

Table  2.2-44:  EM  EventlsActFail  Information. 


2. 2. 4. 1.3  EM  EventlsActFail 


This  routine  returns  whether  the  passed  event  is  related  to  power  status  in  the  lamplighter. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

event 

Even* 

events. h 

Return  Values 

Return  Value 

Type 

Meaning 

eventjable 

[EMJEventGetlndex(event)]. 

power 

int 

Whether  the  event  is  related 
to  power  status. 

Calls 

Function 

Where  Described 

EM  lEventGetlndex 

this  file 

Table  2.2-45:  EM  EventlsPower  Information. 


2.2.4. 1.4  EM  EventGetText 


This  routine  returns  the  text  used  to  display  the  event. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

event 

Event 

events. h 

Return  Values 

Return  Value 

Type 

Meaning 

eventjable 

[  E  M_i  Eve  ntGetl  ndex  (event)] . 
eventText 

int 

The  text  used  to  display  the 
event 

Calls 

Function 

Where  Described 

EM  lEventGetlndex 

this  file 

Table  2.2-46:  EM  EventGetText  Information. 
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2. 2. 4. 1.5  EM_EventReceive 

This  routine  receives  the  event 


Parameters 


Parameter 


eventPDU 


lETT! 

irs 


Where  Typedef  Declared 


inter  to  MMP  PDUStruct 


Function 


MMP  SendPDU 


Calls 


Where  Described 


Table  2.2-47:  EM  EventReceive  Information. 


2. 2. 4. 1.6  EM_EventPDUFill 

This  routine  fills  the  supplied  PDU  with  the  supplied  information.  If  no  eventPDU  is 
supplied,  one  is  allocated  and  returned,  and  the  user  must  free  it  later.  The  routine  returns  a 
pointer  to  the  filled  in  PDU. 


Parameter 


du 


eventID 


resource  ID 


eventText 


Parameters 


inter  to  char 


Where  Tvoedef  Declared 


Standard 


Standard 


Standard 


Return  Value 


NULL 


eventPDU 


Return  Values 


e  Meanin 


pointer  to  MMP_PDUStruct  I  Unsuccessful 


pointer  to  MMP_PDUStruct  the  filled  in  PDU 


Table  2.2-48  EM  EventPDUFill  Information. 


2. 2. 4. 1.7  EM_SendNewStateEvent 

This  routine  generates  a  state  change  event  for  the  passed  resource  and  forwards  it  to 
subscribers. 
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1  Calls  1 

Function 

Where  Described 

EM  EventPDUFill 

this  file 

EM  EventReceive 

this  file 

Table  2.2-49:  EM_SendNewStateEvent  Information. 

2.2.4. 1.9  EM_SubscriptionReceive 

This  routine  accepts  a  subscription  request  and  adds  it  to  the  list  of  active  subscriptions. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

subscription 

pointer  to  Subscription 

Calls 

Function 

Where  Described 

EM.  iCopySubscription 

this  file 

Table  2.2-50:  EM_SubscnptionReceive  Information. 

2.2.4.1.10  EM_LogEventText 

This  routine  logs  the  passed  event  text  into  the  event  log.  If  the  time  is  not  NULL,  the  time 
is  written  into  die  evmt  Ic  j  in  an  ASCII  representation  of  the  log  time. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

text 

pointer  to  char 

Standard 

time 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

EM  iGetTimeField 

this  file 

Table  2.2-51:  EM_LogEventText  Information. 
2.2.4.1.11  EM_CleanUp 

This  routine  performs  any  nicessary  cleanup  for  the  EM  module. 


BBN  Systems  and  Technologies 


Network  Operations  and  Maintenance  CSCI 


2.2.4.1.12  EMJGetTImeField 

This  internal  routine  returns  a  static  string  containing  the  current  time  formatted  correctly 
for  the  event  log. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

pointer  to  char 

Unsuccessful 

timeBuf 

pointer  to  char 

The  formatted  current  time 

Table  2.2-52  EM_iGetTimeField  Information. 
2.2.4.1.13  EM_iCopySubscriptions 

This  routine  returns  a  newly  memory  allocated  copy  of  the  passed  event  Subscription. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

old 

pointer  to  Subscription 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

new 

pointer  to  Subscription 

The  memory  allocated  copy  of 
the  event  Subscription. 

1  Calls  1 

Function 

Where  Described 

StrinaCreateCopy 

strinqs.c 

Table  2.2-53:  function  Information. 
2.2.4.1.14  EM_iEventGetIndex 

This  routine  returns  the  proper  index  into  the  event  table  for  the  passed  event. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

event 

Event 

Return  Values 

Return  Value 

Type 

Meaning 

index 

short 

The  index  into  the  event  table 
for  event. 

Table  2.2-54:  EM  iEventGetIndex  Information. 


2. 2. 4. 2  events.h  CSU  Description  (/simnet/cmd/nom/mini) 

This  CSU  is  the  interface  file  for  events.c. 
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2.2.5  Interface  to  Comms.  CSC  Description 


This  lower-level  CSC  provides  an  interface  between  MAP  and  simulators.  This  interface 
uses  two  protocols,  shared  memory,  and  a  local  monitor  protocol.  This  interface  accesses 
SIM  status  information  in  shared  memory  which  enables  MAP  to  determine  whether  a  SIM 
host  is  running  and  connected  to  the  SIMNET  netwcaic.  The  monitor  protocol  defines  the 
message  PDUs  used  in  polling  for  a  SIM  "heartbeat"  It  also  defmes  ^e  message  formats 
that  allow  MAP  to  pipe  management  commands  to  renx>te  simulators. 


A  functional  breakdown  of  this  lower-level  CSC  into  CSUs  is  shown  in  Figure  2.2.5- 1. 
Additionally,  this  CSC  cross-references  the  equipment.c  CSU  (section  2.2. 1.1),  monipc.h 
CSU(Section  2.4.4.5),  and  mon_rmcd.c  (Section  2.4.5. 1). 


Interface  to 
NO&M  Comm. 

2.2.5 


rsend.c 
2.2.5. 1 


Figure  2.2.5- 1:  MAP-Interface  to  Comms. 

2.2.5. 1  rsend.c  CSU  Description  (/simnet/cmd/nom/mini) 

This  CSU  is  a  high-level  interface  for  sending  text  strings  to  remote  simulators  via  the 
Comms.  CSC.  It  uses  the  protocol  defined  in  monipc.h  to  make  requests  of  the  Comms. 
CSC.  Specifically,  this  sends  Unix  commands  to  Masscomps  such  as  sync  and  reboot. 
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2. 2. 5. 1.1  SendToRemoteShell 

This  routine  sends  a  text  string  to  a  shell  executing  on  a  remote  simulator. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

address 

pointer  to  NetworkAddress 

text 

pointer  to  char 

Standard 

channel 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

LkUpSocket 

ibipc  in  MCC  CSCI 

SendMsa 

Sbiocin  MCC  CSCI 

Table  2.2-55:  SendToRemoteShell  Information. 
2. 2. 5. 1.2  SendToRemoteHost 

This  routine  sends  a  command  to  the  remote  host,  regardless  of  the  channel. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

address 

pointer  to  NetworkAddress 

text 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

LkUpSocket 

Kbipc  in  MCC  CSCI 

SendMsg 

Nbipc  in  MCC  CSCI 

Table  2.2-56:  SendToRemoteHost  Information. 


2.2.6  Interface  to  Lamplighter-int  CSC  Description 

This  lower-level  CSC  receives  power  events  from  the  Lamplighter  Interface  by  accessing 
shared  memory,  and  sends  power  requests  to  the  Lamplighter  Interface  using  Manager- 
Manager  protocol. 

A  functional  breakdown  of  this  lower-level  CSC  into  CSUs  is  shown  in  Figure  2.2.6-1. 
Additionally,  this  CSC  references  CSU  mini_ipc.c  (Section  22.13). 
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Interface 

to 

Lamp-int 

2.2.6 


mmp.c 

2.2.6.1 

mmp.h 

2.2.6.2 


Figure  2.2.6-1  MAP— Interface  to  Lamplighter-int. 

2.2.6. 1  mmp.c  CSU  Description  (/simnet/cmd/nom/mini) 

This  CSU  contains  support  for  sending  and  receiving  Manager-Manager  Protocol. 

2. 2. 6. 1.1  MMP_ProcessPDU 

This  routine  is  the  central  handler  for  all  Manager-Manager  PDUs  received  by  tl;e  NOM 
Management  Application  server  process.  First  the  transfer  syntax  and  the  internal  PDU 
syntax  are  translated.  The  routine  performs  further  processing  based  on  the  kind  of  PDU 
received.  requestID  identifies  the  DPC  transaction. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

psu 

pointer  to  MMP  PDUStruct 

requestID 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

MMP  ProcessEvent 

MMP.C 

MMP.  DispatchActionReq 

MMP.C 

Table  2.2-57;  MMP  ProcessPDU  Information. 
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2. 2. 6. 1.2  MMP_DispatchActionReq 

This  routine  dispatches  all  management  action  requests.  requestID  identifies  the  IPC 
transaction. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

pdu 

pointer  to  MMP  PDUStmct 

requestID 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

EquipmentPowerdown 

equipment.c 

MMP  SendPDU 

MMP.c 

Sim  ActivateFromRequest 

simulators.c 

MMP  ActionToFunction 

Sim  GetActivateDefaults 

simulators.c 

Table  2.2-58:  MMP_DispatchActionReq  Information. 


2.2.6. 1.3  MMP_ProcessEvent 

This  routine  processes  all  events  received  via  Management-Management  protocol. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

pdu 

pointer  to  MMP  PDUStrucf 

1  Calls  1 

Function 

Where  Described 

Equip  ProcessEvent 

equipment.c 

Table  2.2-59:  MMP  ProcessEvent  Information. 


2.2.6. 1.4  MMP_SendPDU 


This  routine  takes  the  passed  internal  representation  of  the  MMP  PDU,  converts  it  into  the 
transfer  syntax  and  asynchronously  sends  it  to  the  specified  destination  using  the 
appropriate  communication. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

destination 

pointer  to  char 

Standard 

pdu 

pointer  to  MMP  PDUStruct 

Calls 

Function 

Where  Described 

IPC  SendMessaqe 

libipc  in  MCC  CSCI 

Table  2.2-60  MMP  SendPDU  Information. 
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2. 2. 6. 2  mmp.h  CSU  Description  (/simnet/cmd/nom/mini) 

This  is  the  interface  file  for  mmp.c. 

2.2.7  Interface  to  GUI  CSC  Description 


This  lower-level  CSC  accepts  GUI  requests  which  it  formats  for  dispatching  to  the 
Lamplighter  Interface  and  Comms  CSCs.  It  also  sends  error  reports  to  GUI.  This  CSC 
sends  an  acknowledgement  to  GUI  upon  receiving  a  request,  and  returns  a  failure  message 
if  the  requested  acdon  failed. 

A  functional  breakdown  of  this  lower-level  CSC  into  CSUs  is  shown  in  Figure  2.2.7-1. 
Additionally,  this  CSC  references  CSUs  mmp.c  and  mmp.h  (Section  2.2.6. 1). 


Interface 
to  GUI 

2.2.7 


minijpc.c 

2.2.7.1 


Figure  2.2.7-1:  MAP-Interface  to  GUI. 
2.2.7. 1  minMpc.c  CSU  Description  (/simnet/cmd/nom/mini) 
This  CSU  provides  higher-level  interface  for  IPC. 
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2. 2. 7. 1.1  IPCJnitIPC 

This  routine  initializes  the  IPC  for  the  NOM  Graphical  User  Inteface.  Sockets  and  handlers 
are  established  for  receiving  messages.  The  NOM  shared  memory  is  attached  and 
initialized.  This  routine  opens  communications  with  the  server  process.  The  YUMM 
usage  is  initialized.  The  NOM  is  restricted  to  one  GUI  running  at  a  time.  If  a  socket  has 
this  process  name  associated  with  it,  it  must  be  deleted  (the  process  probably  died  without 
closing).  The  message  handler  is  registered  to  receive  messages. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

procName 

pointer  to  char 

Standard 

Calls 

Function 

Where  Described 

AttachSharedMem 

YUMMInit 

Kbipc  in  MCC  CSCI 

YUMMProcess 

libipc  in  MCC  CSCI 

LkUpSocket 

kbipc  in  MCC  CSCI 

CloseSocket 

libipc  in  MCC  CSCI 

OpenSocket 

libipc  in  MCC  CSCI 

Table  2.2-61:  IPC_lnitIPC  Information. 

2.2.7. 1.2  IPC_ProcessMessage 

This  routine  is  the  YUMM  message  receipt  handler  for  any  protocol  type.  Alarms  are 
disabled  while  messages  are  being  processed,  then  reenabled  when  finished.  The  message 
is  dispatched  to  the  proper  protocol  handler. 


1  Parameters  I 

1  Parameter 

Where  Tvpedef  Declared 

int 

Standard 

kind 

long 

Stand?  rd 

length 

int 

Standard 

data 

pointer  to  char 

Standard 

requestID 

long 

Standard 

1  Calls  1 

Function 

Where  Described 

MMP  ProcessPDU 

MMP.C 

AlarmsEnabled 

ibipc  in  MCC  CSCI 

Table  2.2-62 


IPC_ProcessMessage  Information. 
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2. 2. 7. 1.3  IPC_TraceMessage 

This  routine  is  the  handler  used  when  tracing  YUMM  messages.  The  routine  assumes  the 
message  is  a  NOM  MMP  PDU. 


1  Parameters  I 

[Parameter 

Where  Tvoedef  Declared 

char 

Standard 

tid 

char 

Standard 

dstSkt 

YUMMSocket 

libipc 

rspSkt 

YUMMSocket 

libipc 

kind 

long 

Standard 

lenath 

int 

Standard 

data 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

MMP  Trace  PDU 

MMP.C 

Table  2.2-63:  IPC_TraceMessage  Information. 

2.2.7. 1.4  IPC_SendMessage 

This  routine  sends  data  to  the  specified  process  using  YUMM  IPC.  Each  time  a  message  is 
sent,  a  YUMM  lookup  is  performed  in  order  to  find  any  changes  in  the  sockets.  The 
routine  returns  0  if  successful  and  an  error  code  if  unsuccessful. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

destination 

pointer  to  char 

Stnadard 

kind 

Iona 

Standard 

length 

int 

Standard 

data 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

LkUpSocket 

libipc  in  MCC  CSCI 

libipc  in  MCC  CSCI 

Table  2.2-64: 


IPC_SendMessage  Information. 
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2.2.8  Interface  to  SIMNET  Network  CSC  Description 

This  CSC  currently  uses  Simulation,  Data  Collection,  and  Management  SIMNET  protocols 
to  communicate  v  ith  simulator  hosts.  These  protocols  are  described  in  the  BBN  Report 
listed  earlier,  titled  "SIMNET  Network  and  Protocols."  Vehicle  PDUs  are  received  by  this 
CSC,  filtered,  and  stored  in  shared  memory. 

A  functional  breakdown  of  this  lower-level  CSC  into  CSUs  is  shown  in  Figure  2.2.8-1. 


Interface  to 

SIMNET 

Network 

2.2.8 


pdu.c 

2.2.8.1 

pdu.h 

2.2.82 

pduio.c 

2.28.3 

pduio.h 

2.28.4 

nom_filter.c 

2.2.8.5 


Figure  2.2.8-1:  MAP  Interface  to  Simnet  Network. 
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2. 2. 8.1  pdu.c  CSU  Description  (/simnet/cmd/nom/mini) 


This  CSU  provides  support  for  sending  and  receiving  SIMNET  PDUs.  This  file  contains 
routines  for  processing  SIMNET  PDUs. 


2.2.8.1.1  PDU  ProcessPDU 


This  is  the  central  PDU  processing  dispatch  routine.  It  handles  all  PDUs  received  from  the 
CMC  net.  This  uses  supporting  subroutines  in  this  module  to  dispatch  PDUs  from  the 
different  protocols  (e.g,  sim,  mgmgt,  data). 

2.2.8. 1  PDU  ProcessPDU 


1  Parameters  | 

Parameter 

Where  Tvpedef  Declared 

assoc 

pointer  to  Association  PDU 

1  Calls  1 

Function 

Where  Described 

PDU  ProcessMqmtPDU 

this  file 

PDU  ProcessDataPDU 

this  file 

DRN  PrintAssociationPDU 

Table  2.2-65:  PDU  ProcessPDU  Information. 


2.2.8. 1.2  PDU_ProcessDataPDU 

This  function  processes  a  datagram  PDU  pertaining  to  the  Simulation  Protocol. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

assoc 

pointer  to  AssociationPDU 

site 

int 

Standard 

host 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

Equip  VehicleStatusReceive 
d 

equipment.c 

Table  2.2-66:  PDU  ProcessDataPDU  Information. 
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2. 2.8.1. 3  PDU_ProcessMgintPDU 

This  function  processes  a  PDU  pertaining  to  the  Management  Protocol.  It  gets  a  handle  on 
the  equipment  index  for  this  PDU.  This  function  processes  all  enor  report  PDUs;  if  there 
is  no  equip  index,  the  PDU  is  ignored-  it  is  either  from  a  renwte  site  or  a  tape  being  played 
back.  This  function  dispatches,  using  the  appropriate  message  to  the  equipment  index. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

assoc 

pointer  to  AssociationPDU 

Calls 

Function 

Where  Described 

EM  LoqEventText 

events.c 

Equip  EguipmentReceived 

equipment.c 

Equip  ErrorReceived 

equipment. c 

Table  2.2-67:  PDU_ProcessMgmtPDU  Information. 

2. 2. 8. 2  pdu.h  CSU  Description  (/simnet/cmd/nom/mini) 

This  is  the  interface  file  for  pdu.c. 

2. 2. 8. 3  pduio.c  CSU  Description  (/simnet/cmd/nom/mini) 

This  CSU  initializes,  polls,  and  shuts  down  the  network  interface.  This  CSU  provides  a 
service  interface  for  MAP  to  send  a  request,  and  processes  incoming  SIMNET  PDUs. 
This  file  front-ends  the  network  interface  at  the  PDU  level. 

2.2.8.3.1  Networkinitialize 

This  function  initializes  the  interface  to  the  network  for  reading  and  writing  PDUs.  This 
includes  initializing  variables  and  the  association  layer  of  the  SIMNET  network. 


1  Calls  1 

Function 

Where  Described 

AssocError 

libassoc  in  MCC  CSCI  document 

net  stop 

libnetif  in  MCC  CSCI  document 

net  prom 

libnetif  in  MCC  CSCI  document 

net  flush 

libnetif  in  MCC  CSCI  document 

AssocGetSimAddress 

libassoc  in  MCC  CSCI  document 

AssocOpen 

libassoc  in  MCC  CSCI  document 

Table  2.2-68:  Networkinitialize  Information. 
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2. 2. 8. 3. 2  PollNetwork 


This  function  polls  the  network  for  any  queued  PDUs  waiting  to  be  heard.  It  returns 
whether  there  is  a  backlog  of  PDUs.  This  function  declares  tiie  global  variable,  int  ermo. 
This  function  periodically  sends  a  network  handle  to  the  association  layer,  sets  a  high 
priority  to  avoid  being  interrupted,  and  processes  n  PDUs  at  a  time,  to  allow  other  periodic 
processing. 


1  Return  Values  1 

Return  Value 

Meaning 

TRUE 

int 

there  is  a  backlog  of  PDUs 

FALSE 

int 

there  is  no  backlog  of  PDUs 

1  Calls  1 

Function 

Where  Described 

AssocTickAssocLaver 

libassoc.a  in  MCC  CSCI 

AssocReceiveAssocPDU 

libassoc.a  in  MCC  CSCI 

PDU  ProcessPDU 

pdu.c 

Table  2.2-69:  PollNetwork  Information. 
2. 2. 8. 3. 3  NetworkClose 

This  leaves  the  network  interface  in  the  approved  condition. 


1  Calls  1 

Function 

Where  Described 

net  close 

libnetif  in  MCC  CSCI  document 

Table  2.2-70:  NetworkClose  Information. 

2. 2. 8. 4  pduio.h  CSU  Description  (/simnet/cmd/nom/mini) 

This  is  the  interface  file  for  pduio.c. 

2. 2. 8. 5  nom_filter.c  CSU  Description  (/simnet/cmd/nom/mini) 

This  file  contains  NOM-specific  filter  code;  it  is  used  to  get  adequate  performance  out  of  the 
NOM.  Currently  this  filters  out  Appearance  PDUs  in  addition  to  NOM-irrelevant  PDUs. 
This  function  is  downloaded  onto  CMC  card  during  initialization. 

2. 2. 8. 5.1  do_init 

This  code  is  predefined  for  reference  by  special  code  on  the  CMC  card. 
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2. 2. 8. 5. 2  do_ioctI 

This  code  is  predefined  for  reference  by  special  code  on  the  CMC  card. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

£ 

pointer  to  char 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

int 

Successful 

Table  2.2-71:  do_ioctl  Information. 

2. 2. 8. 5. 3  do_tick 

This  code  is  predefined  for  reference  by  special  code  on  the  CMC  card. 

2. 2. 8. 5. 4  do_packet_from_host 

This  function  sends  a  packet  out  on  the  network. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

Dkt 

pointer  to  short 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

SEND_PACKET 

int 

Whether  the  packet  was 
successfully  sent 

Table  2.2-72:  do_packet_from_host  Information. 


2. 2. 8. 5. 5  do_packet_from_network 

This  function  reads  and  processes  both  2.0  and  802.3  packets.from  simulators.  The  data 
are  not  ag^egating  PDUs,  so  it  can  be  assumed  that  a  PDU  is  a  single  association  PDU. 
This  function  examines  the  association  layer  header  to  see  where  the  data  is  stored, 
depending  upon  whether  it  is  in  a  datagram,  request,  or  response.  It  selects  the  kinds  of 
PDUs  the  NOM  is  interested  in-they  are:  Data  Collection,  Vehicle  Status,  management, 
and  activate/deactivateResponse  (protocols  are  described  in  "SIMNET  Network  and 
Protocols,"-  listed  under  "Related  Documents,"  Section  1.7.). 
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1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

pkt 

pointer  to  NetworkPacket 

! 

Return  Values  1 

Return  Value 

Type 

Meaning 

SEND_PACKET 

int 

The  PDU  is  one  of  the  PDU 
types  the  NOM  is  interested  in 

FREE_PACKET 

int 

The  PDU  only  contains 
padding,  or  the  NOM  is  not 
interested  in  the  packet 

Calls 

Function 

Where  Described 

GET  DATA  PTR 

Table  2.2-73:  do_packet_froni_network  Information. 


2.2.9  Standalone  CSC  Description 

This  CSC  enables  MAP  to  be  used  as  a  standalone  utility,  accepting  commands  directly 
from  the  terminal  without  GUI  support. 

A  functional  breakdown  of  this  lower-level  CSC  into  CSUs  is  shown  in  Figure  2.2.9-1 

Standalone 

2.2.9 


tty_ui.c 

2.2.9. 1 


ui_strings.c 

2.2.9.2 

ui_strings.h 

2.2.9.3 


Figure  2.2.9-1:  MAP-Standalone 
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2.2.9. 1  tty_ui.c  CSU  Description  (/simnet/emd/nom/mini) 

This  CSU  actively  interfaces  to  the  terminal  to  gamer  input  commands  and  parse  them.  It 
then  interfaces  in  a  similar  manner  as  mmp.c  to  the  functionality  provided  by  the  MAP. 

This  file  provides  ASCII  terminal  interface  to  MAP.  The  typename  'command'  is 
typedefined  in  this  file. 

2. 2. 9. 1.1  Ullnitialize 

This  function  initializes  UI.  It  sets  flags  to  configure  the  UI  for  non-blocking  reads  which 
do  not  wait  for  input. 

2. 2. 9. 1.2  UIRestore 

This  function  restores  UI  to  initial  settings. 

2.2.9. 1.3  PollBackgroundTasks 

This  function  checks  for  alarms,  PDUs,  and  internal  maintenance.  This  function  allows 
some  alarms  to  slip  in  by  calling  astpause.  This  call  will  also  allow  other  processes  to  slip 
in  if  MAP  is  idle. 


1  Calls  i 

Function 

Where  Described 

AlarmsEnabled 

libipc  in  MCC  CSCI 

PollNetwork 

pduio.c 

tickCount 

Equipment  DoMonitor 

equipment. c 

Table  2.2-74:  PollBackgroundTasks  Information. 

2.2.9. 1.4  UI_MasterPoll 

This  function  is  used  in  synchronizing  all  periodic  tasks.  It  checks  for  input  from  the  user. 


1  Calls  1 

Function 

Where  Described 

UserPrompt 

PollBackqroundTasks 

this  file 

PollUser 

this  file 

RunCommand 

Table  2.2-75:  UI  MasterPoll  Information. 
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2. 2. 9. 1.5  PolIUser 


This  function  does  a  non-blocking  read  for  user  input.  The  routine  returns  FALSE  if  no 
input  is  ready.  Currently,  as  there  is  never  user  input,  this  function  will  never  return 


TRUE. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

buffer 

pointer  to  char 

Standard 

1  Return  Values  1 

Return  Value 

Meaning  | 

TRUE 

int 

FALSE 

int 

input  is  ready  | 

1  Calls  1 

Function 

Where  Described 

GetLine 

Table  2.2-76:  PolIUser  Information. 


2. 2. 9. 2  ui_strings.c  CSU  Description  (/simnet/cmd/nom/mini) 

This  CSU  provides  strings  which  are  displayed  to  the  user  to  represent  different  parameters 
and  values. 

This  file  contains  strings  used  in  User  Interface.  It  includes  strings  for  command 
keywords,  help  text  This  file  also  includes  text  for  reporting  events,  printing  out 
equipment  status,  detailing  simulator  state,  and  confirm  operations,  and  maintenance  file 
output  by  the  NOM. 


2. 2. 9. 3  ui_strings.h  CSU  Description  (/simnet/cmd/nom/mini) 

This  is  the  interface  file  for  ui_strings.c. 
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2.3  Lamplighter  Interface  CSC  Description 

The  Lamplighter  CSC  interfaces  to  the  power  controller.  This  process  also  normally  acts  as 
a  deamon,  polling  the  power  status  of  simulators  regularly,  and  reporting  to  the  MAP 
whenever  an  anomaly  is  detected.  Lamp-int  translates  requests  which  it  receives  in 
messages  into  the  format  accepted  by  the  power  controller.  Lamplighter  power  reports  are 
evaluated  by  MAP,  using  operator-set  threshold  values,  to  determine  whether  an 
outstanding  event  has  occurred. 

A  functional  breakdown  of  Lamplighter  Interface  is  illustrated  in  Figure  2.3-1. 


Figure  2.3*1:  Lamplighter  Interface  CSC  Structure. 


2.3.1  Lamplighter  Interface  Processing  CSC  Description 

This  lower-level  CSC  polls  the  power  controller  for  power  status.  MAP 
powerup/powerdown  command  requests  which  are  sent  to  the  higher-level  CSC  are 
translated  by  this  lower-level  CSC  into  serial  messages  which  also  dispatches  the  messages 
to  the  power  controller. 
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A  functional  breakdown  of  this  lower-level  CSC  into  CSUs  is  shown  in  Figure  2.3. 1-1. 


Lamplighter  IF 
Processing 

2.3.1 


lampjntc 
2.3.1. 1 


IF=lnterface 

Figure  2.3.1-1:  Lamplighter  Interface— Lamplighter  Processing. 

2.3. 1.1  lamp^int.c  CSU  Description  (/simnet/cmd/nom/lamp) 

This  file  contains  functions  that  interface  to  a  lamplighter  control  unit  and  to  NOM  shared 
memory. 


2. 3. 1.1.1  main 

This  is  the  main  function  for  lamp  process.  It  uses  IPC  protocol  to  set  up  communications 
with  MAP,  using  IPC  protocol. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

aroc 

int 

Standard 

arqv 

pointer  to  arrav  of  char 

Standard 

Calls 

Function 

Where  Described 

YUMMInit 

libipc  in  MCC  CSCI 

YUM  M  Process 

libipc  in  MCC  CSCI 

LkUpSocket 

libipc  in  MCC  CSCI 

CloseSocket 

libipc  in  MCC  CSCI 

OpenSocket 

libipc  in  MCC  CSCI 

add  lampName 

shmem  acc.c 

main  loop 

this  file 

YUMMCleanUp 

libipc  in  MCC  CSCI 

Init  Alarms 

init  lampnet 

this  file 

Table  2.3>1:  main  Information. 
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2.3. 1.1.2  mainjoop 

This  function  is  the  main  loop  of  this  file.  It  checks  the  power  state  of  simulators. 


1  Calls  1 

Function 

Where  Described 

poll  one  lamp 

this  file 

send  on 

this  file 

send  off 

this  file 

poll  lampnet 

this  file 

Table  2.3-2:  mainjoop  Information. 

2. 3. 1.1. 3  initjampnet 

This  function  initializes  an  interface  with  a  lamplighter  device  RS232  port  Lamp_dev  is 
configured  to  ignore  break  conditions,  to  ignore  parity  errors  (as  the  protocol  between  the 
NOM  and  the  lamp_int  is  not  ASCII),  to  run  at  1200  baud,  to  use  8-bit  characters,  to 
enable  the  receiver,  to  use  a  local  (non-modem)  line,  to  read  at  least  three  characters,  and  to 
wait  up  to  .1  seconds  on  a  read  before  returning.  For  detailed  configuration  information, 
see  the  UNIX  man  page  "termio". 


1  Calls  1 

Function 

Where  Described 

qet  lamp  dev 

shmem  acc.c 

attach  nom  table 

shmem  acc.c 

Table  2.3-3:  initjampnet  Information. 


2. 3. 1.1. 4  process_a_msg 

This  function  reads  and  processes  a  message  from  a  lamplighter  device.  This  message 
includes  SIM  equipment  state  information  such  as:  smoke,  emergency,  ready  state,  and  on- 
state.  Message  contents  are  stored  in  shared  memory. 


1  Calls  1 

Function 

Where  Described 

find  shmem  index 

shmem  acc.c 

aet  smokestate 

shmem  acc.c 

send  mini  ipc 

this  file 

aet  readystate 

shmem  acc.c 

aet  emstate 

shmem  acc.c 

set  powerstate 

shmem  acc.c 

set  readystate 

shmem  acc.c 

set  smokestate 

shmem  acc.c 

set  emstate 

shmem  acc.c 

Table  2.3-4:  process_a_msg  Information. 
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2. 3. 1.1. 5  ipc_process 

This  function  processes  request  for  status  of  requested  actions.. 


Parameters 


Parameter 


e 


msQ  kind 


msQ  len 


dumm 


msQ  data 


IE17? 


inter  to  char 


Where  Tvpedef  Declared 


Standard 


Standard 


Standard 


Standard 


Standard 


Calls 

Function 

Where  Described 

AlarmsEnabled 

ibipc  a  in  MCC  CSCI 

send  on 

this  file 

aet  lamp  addr 

shmem  acc.c 

Table 

2.3-5:  ipc_process  Information. 

2. 3. 1.1. 6  poll_lampnet 

This  function  polls  the  lampdevice  for  SIM  equipment  input. 


Parameters 


Parameter 


a 


lEiT:! 


e 


Alarm 


Where  Tvpedef  Declared 


Standard 


Function 


werstate 


ut  ms 


et  lamp  addr 


rocess  a  ms 


SetAlarm 


Calls 


Where  Described 


shmem  acc.c 


msosw.c 


shmem  acc.c 


this  file 


Table  2.3-6:  polMampnet  Information 
2. 3. 1.1. 7  poll_one_lanip 

This  function  polls  for  input  from  one  SIM. 


Parameters 


e 


int 


Parameter 


num 


Where  Tvpedef  Declared 


Standard 


Calls 


Function  Where  Described 


rocess  a  msa  this  file 


Table  2.3-7:  poll_one_lamp  Information. 
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2.3. 1.1.8  putmsg 

This  function  puts  out  a  message  to  the  lamplighter  device. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

addr 

char 

Standard 

cmd 

chnr 

Standard 

Calls 

Function 

Where  Described 

send  off 

this  file 

Table  2.3-8:  put_insg  Information. 

2.3. 1.1.9  send_on 

This  function  puts  out  a  SIM  on  state  message  to  the  lamplighter  device. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

addr 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

put  msq 

msqsw.c 

Table  2.3-9:  send  on  Information. 


2.3.1.1.10  send_off 

This  function  puts  out  a  SIM  off  message  to  the  lamplighter  device. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

addr 

int 

Standard 

Calls 

Function 

Where  Described 

put  msq 

msqsw.c 

Table  2.3-10:  send  off  Information. 
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Parameter 


addr 


Where  Tvoedef  Declared 


Standard 


Function 


ut  ms 


Calls 


Where  Described 


fnsqsw.c 


Table  2.3-11:  send_e_off  Information. 

2.3.1.1.12  add_ether 

This  function  is  not  used  in  the  version  6.6  release. 

2.3.1.1.13  send_mini_ipc 

This  function  sends  an  IPC  message  to  MAP  about  an  event. 


Parameters 


Parameter 


eveid 


node 


lEiT? 


Where  Tvoedef  Declared 


Standard 


Standard 


Function 


LkUoSocket 


SendMs 


Calls 


Where  Described 


libipc  in  MCC  CSCI 


libipc  in  MCC  CSCI 


Table  2.3-12:  send_mini_ipc  Information. 


2.3.1.1.14  itoa 

This  function  returns  a  pointer  to  a  string  returned  by  a  function  similar  to  the  "C"  function, 
itoa. 


Parameter 


n 


Parameters 


Where  Tvoedef  Declared 


Standard 


Return  Values 

Return  Value 

Type 

Meaning 

s 

pointer  to  char 

String  value 

Table  2.3-13:  itoa  Information. 


148 


BBN  Systems  and  Technologies _ Network  Operations  and  Maintenance  CSCl 

2.3.2  Interface  to  MAP  CSC  Description 

This  lower-level  CSC  formats  and  stores  power  events  into  the  shared  memory  table. 

A  functional  breakdown  of  this  lower-level  CSC  into  CSUs  is  shown  in  Figure  2.3.2-1. 

Interface 
to  MAP 

2.3.2 


shmem_acc.c 
2.3.2. 1 

Figure  2.3.2-1:  Lamplighter  Interface— Interface  to  MAP. 

2. 3. 2.1  shmem_acc.c  CSU  Description  (/simnet/cmd/nom/lamp) 

This  CSU  is  also  used  by  the  CSCs  in  MAP  to  access  shared  memory.  This  file  contains 
functions  that  provide  access  to  various  fields  in  the  struct,  nomEquipTable,  which  is  the 
NOM  shared  memory  table. 

2. 3. 2. 1.1  attach_nom_table 

This  function  accesses  nomEquipTable  in  shared  memory. 


1  Calls  1 

Function 

Where  Described 

AttachSharedMem 

libipc  in  MCC  CSCl 

Table  2.3-14:  attach  nom  table  Information. 


2. 3. 2. 1.2  addJampName 

This  function  copies  the  name  of  a  lamplighter  procedure  into  'lampProcName'. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

s 

pointer  to  char 

Standard 

Table  2.3-15:  addJampName  Information. 
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2.3.2. 1.3  geMamp_dev 

This  function  returns  a  pointer  to  the  character  value  returned  by  get_lamp_dev,  which  is 
the  contents  of  tty_dev. 


1  Return  Values  1 

Return  Value 

Meaning 

nonlnfo->tty_dev 

pointer  to  char 

contents  of  tty_dev 

Table  2.3*16:  get_lainp_dev  Information. 


2.3.2. 1.4  get_numEquip 

This  function  returns  the  contents  of  numEquip. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

nonlnfo->numEquip 

int 

contents  of  numEquip 

Table  2.3-17;  get_Iamp_dev  Information. 


2.3.2. 1.5  get_lamp_addr 

This  function  returns  the  contents  of  lamp_addr  indexed  by  i. 


1  Parameters  1 

Parameter 

wipnnmmmmmmm 

Where  Typedef  Declared 

i 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

nominfo  -> 

equipTablefil.lamp  addr) 

int 

the  contents  of  lamp_addr 

Table  2.3-18:  get_lamp_addr  Information. 
2. 3. 2. 1.6  get_lamp_timeout() 

This  function  returns  the  contents  of  timeout. 


1  Return  Values  1 

Return  Value 

Meaning 

nomlnfo->timeout 

int 

the  contents  of  timeout 
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2. 3. 2. 1.7  set_powerstate 

This  function  writes  value  of  s  into  the  location  of  powerState  indexed  by  j. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

i 

int 

Standard 

s 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

nomlnfo-> 

eguipTablefil. powerState  =  s 

int 

the  contents  of  the 
powerState  indexed  bv  i 

Table  2.3-19:  set_powerstate  Information. 
2.3.2. 1.8  get_powerstate 


This  function  returns  the  contents  of  powerState  indexed  by  j. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

j 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

nominfo  -> 

equipTablelil. powerState 

int 

the  contents  of  powerState 
indexed  by  j 

Table  2.3-20:  get_powerstate  Information. 


2.3.2. 1.9  set_readystate 

This  function  writes  value  of  s  into  the  location  of  readystate  indexed  by  j. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

s 

int 

Standard 

i 

int 

Standard 

Table  2.3-21:  set_readystate  Information. 
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2.3.2.1.10  get_readystate 

This  function  returns  the  contents  of  readystate  indexed  by  j. 


1  Parameters  I 

Parameter 

Tvoe 

Where  Tvpedef  Declared 

J 

int 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

nominfo  -> 

eguipTablern.readvState 

int 

the  contents  of  readyState 
indexed  bv  i 

Table  2.3-22:  get_readystate  Information. 
2.3.2.1.11  set_smokestate 

This  function  writes  value  of  s  into  the  location  of  smokestate  indexed  by  j. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

s 

int 

Standard 

Table  2.3-23:  set_smokestate  Information. 
2.3.2.1.12  get_smokestate 


This  function  returns  the  contents  of  smokestate  indexed  by  j. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

j 

int 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

nominfo  -> 

equipTablefil. smokestate 

int 

the  contents  of  smokestate 
indexed  bv  i 

Table  2.3-24:  get_smokestate  Information. 
2.3.2.1.13  set  emstate 


This  function  writes  value  of  s  into  the  location  of  emergency_offstate  indexed  by  j. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

i 

int 

Standard 

s 

int 

Standard 

Table  2.3-25:  set  emstate  Information. 
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2.3.2.1.14  get_emstate 

This  function  returns  the  contents  of  emergency_offstate  indexed  by  j. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

j 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

nominfo  -> 

equipTable[j].emergency_offs 

tate 

int 

the  contents  of 
emergency  offstate  indexed 

^ _ 

Table  2.3*26:  get_ein_state  Information. 

2.3.2.1.15  find_shmem_index 

This  function  determines  if  la  is  equal  to  any  of  the  values  in  lamp_addr.  If  so,  it  returns 
the  index  to  location  containing  la.  If  not,  this  function  returns  -1. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

ia 

int 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

search  failed 

j 

int 

the  index  to  location 
containina  la 

Table  2.3-27:  find_shmem_index  Information 
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The  NOM-SIM  Communications  CSC  (Comms)  is  distributed  between  processes  resident 
on  the  NOM  and  SIM  hosts.  This  CSC  allows  a  technician  to  manage  simulators  remotely, 
from  a  central  location  at  a  NOM  host  console.  It  also  allows  the  technician  to  control  a 
single  simulator  from  its  locally  attached  SIM  host  console  and  tap  into  any  management 
activity  occurring  at  the  NOM  console  that  affects  the  simulator.  Communications  between 
NOM-  and  SIM-  host-resident  processes  occur  over  the  SIMNET  network. 

The  Communications  CSC  enables  access  from  NOM  to  a  UNIX  shell  on  any  of  the  SIM 
hosts.  This  provides  GUI  with  a  remote  SIM  terminal  window  and  MAP  widi  a  command 
pipe  to  send  management  and  UNIX-like  commands  to  a  remote  SIM  host.UNIX  shell. 
This  CSC  also  enables  NOM  to  start  /stop  a  process  on  a  remote  SIM  host  and  vice-versa; 
in  either  case,  process  output  is  viewable  at  a  NOM  console.  This  CSC  also  allows  a 
console  at  the  NOM  host  to  display  command  input  from  a  console  attached  to  the  remote 
host,  and  vice-versa.  The  Communications  CSC  has  the  following  monitoring  capability:  it 
polls  SIM  hosts  periodically  for  the  presence  or  absence  of  Equipment  PDUs.  This  serves 
as  a  heartbeat  to  indicate  that  a  simulation  process  is  running  and  connected  to  the  SIMNET 
network. 

The  Communications  CSC  may  be  run  without  the  rest  of  the  NOM.  The  CSC  is 
implemented  as  a  distributed  application,  with  a  process  on  the  NOM  host  and  a  process  on 
each  of  the  simulator  hosts. 

A  Communications  request  protocol  is  primarily  used  within  the  Communications  CSC. 
This  request-response  protocol  is  used  to  poll  SIM  hosts  for  a  'heartbeat.'  The 
communications  process  resident  on  the  NOM  host  also  accepts  requests  from  other  NOM 
subsystems.  GUI  uses  an  attachMSGKind  request  indirectly  to  login  and  interact  with 
remote  simulators.  The  MAP  uses  the  textMSGKind  request  to  send  commands  to  remote 
simulators. 

The  NOM  Communications  CSC  is  broken  down  into  these  lower-level  CSCs: 

•  NOM  Host  Communications 

•  SIM  Host  Communications 

•  SIM  User  Interface 

•  Shared  Processes 

•  Start  a  Process 

SIM  Host  Communications  CSC  and  SIM  User  Interface  communicate  with  one  another 
using  a  IPC,  a  local  inter-process  protocol;  NOM  Host  Communications  and  SIM  Host 
Communications  communicate  with  one  another  using  monitor  protocol,  which  is  designed 
for  inter-process  communications  involving  remote  hosts. 
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Functional  breakdown  of  the  NOM-SIM  Communications  (Comms.)  CSC  is  illustrated  in 
Figure  2.4-1. 


Note:  IF=Interface 


Figure  2.4-1:  NOM-SIM  Communications  (Comms.)  CSC  Structure. 


2.4.1  NOM  Host  Processes  CSC 

This  lower-level  CSC  monitors  each  SIM  host's  'heartbeat'  to  determine  whether  the  latter 
is  connected  to  the  network  and  its  processes  are  running.  Such  information  is  available  in 
shared  memory  for  access  by  MAP.  This  CSC  can  start/stop  a  process  on  a  remote  SIM 
host,  request  a  remote  SIM  host  UNIX  shell,  obtain  a  window  into  a  remote  SIM  host 
UNIX  shed  for  interacting  with  a  SIM  host  shell  from  a  NOM  console,  or  for  viewing 
interaction  with  a  SIM  host  shell  from  a  console  locally  attached  to  the  SIM  host.  This  CSC 
can  also  start/stop  a  remote  SIM  host  shell  session,  and  start  or  stop  a  process  in  a  remote 
SIM  host.  This  CSC  also  displays  on  a  NOM  screen  output  from  a  remote  SIM  host 
process.  This  CSC  also  records  session  history  for  all  of  the  remote  shells  it  has  used. 

Additionally,  this  CSC  uses  the  CSU,  mon_wind  (Section  2.1. 6.1). 
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Functional  breakdown  of  this  lower-level  CSC  is  illustrated  in  Figure  2-4a. 


NO&M  Host 
Processes 

2.4.1 


fido.c 

2.4.1 .1 


Figure  2.4-1:.  Comms.—NOM  Host  Processes. 

2.4. 1.1  fido.c  CSU  Description  (/simnet/cmd/nom/monitor) 

This  file  contains  source  code  for  the  monitor  process  that  executes  on  the  NOM  host 

MachineStatus,  ConnectionStatus  are  typedefined  in  this  file. 

This  CSU  runs  on  the  NOM  system  host.  It  is  invoked  when  the  NOM  system 
is  staned. 

When  mon_wind  (Section  2. 1.2.6)  is  used  to  resume  access  to  an  existing,  remote  shell, 
the  fido  process  local  to  mon_wind  may  provide  mon_wind  with  a  transcript  of  the  shell’s 
recent  output.  This  session  history  is  recorded  by  fido  for  aU  the  remote  shells  it  has  been 
involved  with,  up  to  some  maximum  number  of  shells  and  some  maximum  number  of 
characters  per  shell. 

This  CSU  optionally  produces  debugging  output  to  stdout.  It  assumes  the  existence  of  a 
shared  memory  segment  containing  a  table  of  simulators  (placed  there  by  other  components 
of  the  NOM  system) 

2. 4. 1.1.1  main 

This  function  is  the  program  entry  point.  This  function  repeatedly  processes  input  events, 
assembles  a  set  of  the  file  descriptors  for  accepting  input  on,  listens  for  up  to  several 
seconds  on  those  file  descriptors,  processes  any  input  from  the  Ethernet,  processes  any 
input  from  window  processes,  checks  whether  it  is  time  to  poll  each  simulator  out  there, 
times  out  simulators  that  have  not  responded  to  polling,  and  closes  connections  with  the 
failed  machine. 
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1  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

aroc 

int 

Standard 

arov 

pointer  to  array  of  char 

Standard 

1  Calls  1 

Function 

Where  Described 

AttachSharedMem 

Ibipcin  MCC  CSCI 

InitMonitorProcess 

common.c 

PollMonitor 

this  file 

FatalSystemError 

common.c 

ProcessPacket 

this  file 

ProcessWindowText 

this  file 

CloseConnection 

this  file 

Table  2.4-1:  main  Information. 


2. 4. 1.1. 2  ProcessPacket 

This  function  reads  and  processes  a  packet  from  the  Ethernet.  It  determines  if  the  Monitor 
Response  PDU  came  from  a  rover  process  and  determines  whether  the  simulator  it 
represents  is  connected.  If  a  Shell  Status  PDU  reports  that  a  connection  has  closed  or  failed 
to  open,  the  routine  discards  the  record  of  the  connection.  If  sequenceNumber  is  zero,  this 
function  resynchronizes  text  sequence  numbers. 


Function 


FatalSvstemError 


GET  DSAP 


GET  SSAP 


GET  CONTROL 


GET  PROTOID 


GET  ETHER  TYPE 


GET  DATA  PTR 


net  addr  bin  to  str 


SendMonitorResponsePDU 


CloseSocket 


YUMMCleanU 


LookupMachineBy  Address 


ExecuteCommand 


LookuoConnection 


Notify  Window 


CloseConnection 


CircleBufferCopyln 


SendShellAckPDU 


Calls 


Where  Described 


common.c 


libnetif.a  in  MCC  CSCI 


common.c 


Nbipc  in  MCC  CSCI 


libipc  in  MCC  CSCI 


this  file 


common.c 


this  file 


this  file 


this  file 


this  file 


Table  2.4-2:  ProcessPacket  Information. 
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2. 4. 1.1. 3  PollMonitors 

This  function  polls  the  monitors  on  simulators  and  other  NOM  systems. 


1  Calls  1 

Function 

Where  Described 

SendMonitorPDU 

common.c 

Table  2.4-3:  PollMonitors  Information. 
2.4. 1.1. 4  SendShellOpenPDU 

This  function  sends  a  Shell  Open  PDU. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

address 

pointer  to  NetworkAddress 

channel 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

GET  DATA  PTR 

SendMonitorPDU 

common.c 

Table  2.4-4:  SendShellOpenPDU  Information. 
2. 4. 1.1. 5  SendShellAckPDU 

This  function  sends  a  Shell  Ack  PDU,  acknowledging  receipt  of  text. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

connect 

pointer  to  register 
ConnectionStatus 

Calls 

Function 

Where  Described 

GET  DATA  PTR 

SendMonitorPDU 

common.c 

Table  2.4-5:  SendShellOpenPDU  Information. 

2. 4. 1.1. 6  OpenConnection 

This  function  open  a  new  connection  to  a  remote  shell.  It  locates  an  unused  connection 
table  entry  or  reuses  one  that  has  no  window  process  attached.  If  all  entries  are  in  use  it 
tries  to  find  an  entry  to  reuse.  This  function  initializes  the  new  connection  table  entry. 
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Table  2.4-6:  OpenConnection  Information. 
2.4. 1.1.7  CloseConnection 

This  terminates  a  connection  when  a  remote  shell  exits. 


Parameters 


Parameter 


connect 


Where  Typedef  Declared 


Calls 


Where  Described 


Function 


net  addr  bin  to  str 


FatalSvstemError 


Circle  Buff  erFree 


Table  2.4-7:  CloseConnection  Information. 

2. 4. 1.1. 8  LookupConnection 

This  function  finds  a  connection's  status,  given  the  remote  machine's  address  and  channel 
number. 


Parameter 


address 


channel 


Return  Value 


connect 


Function 


net  addr  compare 


Parameters 


e 


inter  to  NetworkAddress 


short 


Return  Values 


Where  Typedef  Declared 


Standard 


Meanin 


pointer  to  ConnectionStatus  I  Successful 


pointer  to  ConnectionStatus  Unsuccessful 


Calls 


Where  Described 


Table  2.4-8:  LookupConnection  Information. 
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2. 4. 1.1. 9  ProcessMessage 

This  function  establishes  communication  with  window  process  and  other  local  clients. 
This  function  processes  a  YUMM  message  to  kill  a  process,  send  a  remote  command, 
attach  a  window  process  to  a  remote  shell,  listen  for  output  from  a  remote  shell,  and  send 
shell  text 


Parameters 


Parameter 


e 


msoLen 


Ein 


msoKind 


msoData 


inter  to  reaister  char 


Where  Tvoedef  Declared 


Standard 


Standard 


Standard 


Standard 


Standard 


Function 


CloseSocket 


YUMMCleanU 


SendRemoteCommandPDU 


FatalSvstemError 


LookuoConnection 


CircleBufferAmount 


CircleBufferCoDvOut 


OoenConnection 


FatalSvstemError 


SendShellODenPDU 


SetTerminalRaw 


LookupMachineBv  Address 


SendShellTextPDU 


Calls 


Where  Described 


fibiDCin  MCC  CSCI 


SbiDCin  MCC  CSCI 


common.c 


common.c 


this  file 


this  file 


common.c 


this  file 


common.c 


this  file 


common.c 


Table  2.4«8:  ProcessMessage  Information. 

2.4.1.1.10  ProcessWindowText 

This  function  processes  input  from  an  window  process.  It  reads  some  text  from  the 
window  process'  pseudo-tty.  An  EOF  on  the  read  signifies  that  the  window  is  gone. 


Parameter 


connect 


Function 


FatalSvstemError 


SendShellTextPDU 


Parameters 


pointer  to  register 
ConnectionStatus 


Calls 


Where  Described 


common.c 


common.c 


Where  Tvoedef  Declared 


Table  2.4-9:  ProcessWindowText  Information. 
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2.4.1.1.11 


NotifyWindow 


This  sends  a  message  string  to  a  window  process. 


1  Parameters  | 

Parameter 

Tvoe 

Where  Typedef  Declared 

connect 

pointer  to  register 
ConnectionStatus 

str 

pointer  to  char 

Standard 

Table  2.4*10:  NotifyWindow  Information. 


2.4.1.1.12  LookupMachineByAddress 


This  function  locates  an  entry  in  the  NOM  equipment  table,  given  its  Ethernet  address. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

address 

pointer  to  NetworkAddress 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

i 

int 

entry  found 

-1 

int 

entry  not  found 

I  Calls  I 

Function 

Where  Described 

net  addr  compare 

Table  2.4-11:  LookupMachineByAddress  Information. 


2.4.2  SIM  Host  Processes  CSC  Description 

This  lower-level  CSC  can  create  a  remote  UNIX  shell  on  a  SIM  host  and  a  command  pipe 
to  the  shell  for  command  input  by  NOM;  obtain  a  window  on  a  local  SIM  host  UNIX  shell 
for  interacting  with  a  SIM  host  shell  from  a  console  locally  attached  to  the  SIM  host  or  for 
viewing  NOM  interaction  with  a  SIM  host  UNIX  shell.  This  CSC  can  also  start/stop  a 
process  on  NOM. 
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Functional  breakdown  of  this  lower-level  CSC  is  illustrated  in  Figure 


2.4.2- 1. 


SIM  Host 
Piocesses 


rover.c 

2.4.2.1 


Figure  2.4.2-1: 


Comms.”SIM  Host  Processes. 


2.4.2. 1  rover.c  CSU  Description  (/simnet/cmd/nom/monitor) 


This  file  cor.iains  source  code  for  the  monitor  process  that  executes  on  UNIX  simulation 
hosts.  Shel'.State  is  a  typename  typedefined  in  this  file. 


A  rover  prc  .-ess  can  spawn  a  shell  and  provide  access  to  it  (for  typed  input  and  displayed 
output)  from  either  a  local  terminal  or  a  remote  NOM  system.  Several  such  spawned  shells 
can  exist  at  one  time  on  a  single  machine;  each  is  identified  by  a  unique  "channel  number" 
(a  low  integer). 


A  shell  spawned  by  a  rover  process  can  continue  to  exist  even  when  no  mon_lcmd, 
mon_wind,  or  tee_in  process  is  being  used  to  access  it,  and  even  when  the  rover  process  is 
no  longer  able  to  communicate  with  its  companion  fido  process.  Access  to  the  shell  can  be 
resum^  at  any  time. 


This  CSU  optionally  produces  debugging  output  to  stdout. 

This  CSU  may  include  one  or  more  channel  numbers;  at  startup,  rover  will  spawn  a  shell 
for  each  channel  number  specified. 

2. 4.2. 1.1  main 


This  function  is  the  program  entry  point.  TTie  routine  does  the  following;  initialization 
common  to  both  monitor  processes,  uses  the  broadcast  address  for  sending  to  the  NOM 
system,  catches  signals  reporting  the  death  of  spawned  shells,  spawns  whatever  shells  are 
requested,  assembles  a  set  of  the  file  descriptors  for  accepting  input,  accepts  inupt  from  a 
shell  it  the  input  is  not  being  conveyed  to  a  remote  system  or  it  the  input  is  being  conveyed 
and  there  is  buffer  space  remaining,  accepts  input  from  any  tee_in  process,  listens  for  up  to 
several  seconds  on  those  file  descriptors,  processes  any  input  from  the  Ethernet,  processes 
any  input  from  the  spawned  shells  and  tee_in  processes,  and  checks  whether  it  is  time  to 
retry  or  abandon  ?  ..ansmission. 
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1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

argc 

int 

Standard 

arqv 

pointer  to  array  of  char 

Standard 

Calls 

Function 

Where  Described 

FatalSystemError 

common.c 

ProcessTeeText 

this  file 

ProcessShellText 

this  file 

CircleBufferAvaii 

SpawnShell 

this  file 

InitMonitorProcess 

common.c 

Table  2.4-12:  main  Information. 


2.4.2. 1.2  ProcessShellText 

This  function  reads  and  forwards  output  generated  by  a  spawned  shell.  If  relaying  text 
from  the  shell  to  a  remote  system,  it  accepts  no  more  text  than  there  is  buffer  capacity  for. 
This  function  tries  to  read  some  text  from  a  shell's  PTY.  If  the  shell  has  a  remote  client, 
this  function  transmits  the  text,  saves  a  copy  of  it  in  the  circular  buffer,  and  forwards  it  to 
any  tee-in  process. 


Parameters 


Parameter 


shell 


lEIT^ 

m 


Where  Tvpedef  Declared 


inter  to  register  ShellStale 


Function 


Circle  BufferAvail 


FatalSystemError 


SendShellStatusPDU 


CloseShell 


CircleBufferAmount 


CircleBufferCoDvIn 


Calls 


Where  Described 


common.c 


this  file 


this  file 


Table  2.4-13;  ProcessShellText  Information. 


2.4.2. 1.3  ProcessTeeText 

This  function  reads  and  distributes  text  from  a  tee-in  process. 


Parameters 


Parameter 


shell 


Where  Tvpedef  Declared 


Function 


FatalSystemError 


Calls 


Where  Described 


common.c 


Table  2.4-14:  ProcessTeeText  Information. 
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2. 4. 2. 1.4  CatchCLDSignal 


This  function  signals  handler  for  SIGCLX)  signals,  reporting  that  child  processes  have 
changed  status. 


1  Calls  1 

Function 

Where  Described 

FatalSystemError 

common.c 

Table  2.4*15:  CatchCLDSignal  Information. 

2.4.2. 1.5  ProcessPacket 

This  function  reads  and  processes  a  packet  from  the  Ethernet  This  function  ensures  that  it 
is  an  802.3  packet  with  ihe  correct  code.  Hus  function  interprets  the  packet  as  a 
Monitor  PDU  and  checks  its  PDU  version  number. 

This  function  performs  these  actions:  responds  to  a  Monitor  Query  with  a  Monitor 
Response,  executes  the  command  in  a  Remote  Command  PDU,  spawns  a  new  shell  or 
reconnects  to  an  existing  one,  notes  the  remote  client  to  which  this  shell  is  connected, 
returns  a  PDU  indicating  success  or  failure,  accepts  text  destined  for  a  shell  and  sends  it  to 
the  shell.  If  shell  is  not  communicating,  it  is  reset  to  conununicate.  This  function  also  notes 
that  receipt  of  text  has  been  acknowledged. 


1  Calls  1 

Function 

Where  Described 

FatalSystemError 

common.c 

GET  DSAP 

GET  SSAP 

GET  CONTROL 

GET  PROTOID 

GET  ETHER  TYPE 

GET  DATA  PTR 

net  addr  bin  to  str 

SendMonitorResponsePDU 

common.c 

LookupShellByChannel 

this  file 

SpawnShell 

this  file 

CircleBufferClear 

SendShellStatusPDU 

this  file 

CircleBufferAdvance 

CircleBufferEmpty 

Table  2.4-16:  ProcessPacket  Information. 
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2. 4. 2. 1.6  RetryTextTransmission 

This  function  retries  or  abandons  transmission  to  a  remote  client. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

shell 

pointer  to  reoister  ShellState 

1  Calls  1 

Function 

Where  Described 

CircleBufferAmount 

CircleBufferCopyOut 

SendShellTextPDU 

common.c 

SendShellStatusPDU 

this  file 

Table  2.4-17:  RetryTextTransmission  Information. 


2. 4. 2. 1.7  SendShellStatusPDU 


This  function  sends  a  Shell  Status  PDU. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

address 

pointer  to  Network  Address 

channel 

int 

Standard 

status 

ShellStatus 

1  Calls  1 

Function 

Where  Described 

GET  DATA  PTR 

SendMonitorPDU 

common.c 

Table  2.4-18:  SendShellStatusPDU  Information. 


2.4.2. 1.8  SpawnShell 

This  function  spawns  and  hooks  up  a  new  shell.  This  function  attempts  to  find  a  free 
pseudo-tty  and  opens  it  for  reading  and  writing.  The  master  PTY's  terminal 
characteristics  are  set. 
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1  Calls  1 

Function 

Where  Described 

SetTerminalRaw 

common.c 

CircleBufferAlloc 

CloseShell 

this  file 

Table 

2.4-19:  SpawnShell  Information. 

2.4.2.1.9  FUNCTION: 

void  CloseShell  (shell) 

This  function  closes  a  shell. 

1  Parameters  I 

Parameter 

Type 

Where  Tvoedef  Declared 

shell 

Dointer  to  reoister  ShellState 

Calls 

Function 

Where  Described 

FatalSystemError 

common.c 

CircleBufferFree 

Table  2.4-20:  CloseShell  Information. 
2.4.2.1.10  LookupShellByChannel 

This  function  looks  up  the  shell  by  channel. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

channel 

short 

Standartd 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

0 

pointer  to  ShellState 

shell  not  found 

shell 

pointer  to  ShellState 

value  of  shell 

Table  2.4-21:  LookupShellByChannel  Information. 

2.4.2.1.11  FUNCTION:  void  ProcessMessage  (type,  msgKind,  msgLen, 
msgData,  dummy) 

This  function  communicates  with  tee-in  process  and  other  local  clients.  It  processes  a 
YUMM  message  received  from  any  of  the  clients.  Messages  received  can  be:  kill  a 
process,  execute  command  on  a  remote  system,  open  a  shell  connection  to  a  tee-in  process 
(a  local  client),  or  list  open  channels. 
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1  Parameters  I 

■  Parameter 

Where  Typedef  Declared 

int 

Standard 

1  msaLen 

int 

Standard 

int 

Standard 

1  msoKind 

Iona 

Standard 

pointer  to  reqister  char 

Standard 

1  Calls  1 

Function 

Where  Described 

CloseSocket 

ibipcin  MCCCSCI 

YUMMCleanUp 

libipc  in  MCC  CSCI 

SendRemoteCommandPDU 

common.c 

FatalSvstemError 

common.c 

LookupShellBvChannel 

this  file 

SetTerminalRaw 

common.c 

T  ransmitConnectionList 

this  file 

Table  2.4-22:  ProcessMessage  Information. 


2.4.2.1.12  T ransmitConnectionList 


This  function  sends  a  list  of  open  shells  to  a  tee-in  process.  It  opens  a  pseudo-tty  leading 
to  the  tee-in  process,  sends  a  text  with  the  address  of  the  NOM  system,  and  sends  a  text 
with  a  list  of  channels  open. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

ptyName 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

FatalSvstemError 

common.c 

net_addr_bin  to  str 

Table  2.4-23:  TransmitConnectionList  Information. 


2.4.3  SIM  User  Interface  CSC  Description 

This  lower-level  CSC  enables  a  user  at  a  SIM  console  to  tap  into  the  interaction  between  a 
user  at  a  NOM  console  and  a  SIM  UNIX  shell. 

Functional  breakdown  of  this  lower-level  CSC  is  illustrated  in  Figure  2.4.3- 1. 
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SIM  User  IF 

2.4.3 


teejn.c 

2.4.3.1 

Figure  2.4.3'1:  Coinins.»SIM  User  Interface. 

2.4.3. 1  teejn.c  CSU  Description  (/simnet/cmd/nom/monitor) 

This  file  contains  source  code  for  a  program  that  taps  in  on  connections  maintained  by 
rover,  the  remote  system  monitor  process. 

This  CSU  can  be  used  to  obtain  a  "window"  into  a  shell  spawned  by  a  local  rover  process; 
it  is  used  from  a  simulator  host. 

This  CSU  uses  the  channel  number  of  the  local  shell.  If  this  argument  is  not  present, 
tee_in  simply  prints  a  list  of  the  channel  numbers  of  the  local  shells  that  currently  exist, 
then  tee_in  exits.  If  the  argument  is  present  but  it  specifies  a  shell  that  does  not  exist,  a 
shell  is  spawned  for  the  specified  channel. 

Characters  typed  to  tee_in's  stdin  are  passed  immediately  to  the  local  shell's  stdin,  without 
modification  or  local  echoing  (there  are  two  exceptions  noted  below).  Characters  output  by 
the  local  shell  to  its  stdout  or  stderr  are  conveyed  to  tee_in  and  output  to  its  stdout,  also 
without  modification.  Tee_in  recognizes  two  character  sequences  as  special  commands  that 
it  interprets  rather  than  passing  along  to  the  local  shell. 

2.4.3. 1.1  main 

This  function  is  the  program  entry  point.  This  function  calls  functions  to  do  the  following: 
check  number  of  command  line  arguments,  look  up  the  YUMM  socket  on  which  rover  is 
listening,  and  open  a  free  pseudo-tty  for  communicating  with  rover. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

aroc 

int 

Standard 

arov 

pointer  to  array  of  char 

Standard 

Calls 

Function 

Where  Described 

YUMMInit 

libipc  in  MCC  CSCI 

YUMM  Process 

Sbipc  in  MCC  CSCI 

LkUpSocket 

libipc  in  MCC  CSCI 

ListConnections 

this  file 

AttachToChannel 

this  file 

Table  2.4-24:  main  Information. 
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2. 4. 3. 1.2  ListConnections 

This  function  obtains  a  list  of  active  connections  fix)m  rover. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

fd 

int 

Standard 

ptvName 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

FatalSvslemEnror 

common.c 

SendMsq 

Ibipcin  MCC  CSCI 

Table  2.4-25:  ListConnections  Information. 

2.4.3. 1.3  AttachToChannel 

This  function  taps  into  an  open  connection  maintained  by  rover.  A  finite  state  machine  is 
used  to  watch  for  escape  sequences  that  terminate  or  suspend  the  tee_in  process.  NOM 
Comms  is  in  normal  state  until  a  carriage  return  has  been  seen. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

fd 

int 

Standard 

channel 

int 

Standard 

ptvName 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

SendMsq 

Sbipc  in  MCC  CSCI 

FatalSystemError 

common.c 

SetTerminalRaw 

common.c 

RestoreTerminal 

common.c 

Table  2.4-26:  AttachToChannel  Information. 


2.4.4  Shared  Processes  CSC  Description 

This  lower-level  CSC  provides  procedures  and  definitions  for  use  by  more  than  one  NOM 
Communications  CSC. 

Functional  breakdown  of  this  lower-level  CSC  is  illustrated  in  Figure  2.4.4- 1. 
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Shared 

Processes 

2.4.4 


common.c 

2.4.4.1 

circle.c 

2.4.4.2 

circle.h 

2.4.4.3 
p_mon.h 

2.4.4 .4 

monipc.h 

2.4.4.5 

monitor,  h 

2.4.4.6 


Figure  2.4.4-1:  Comms.-Shared  Processes. 

2.4.4. 1  common.c  CSU  Description  (/simnet/cmd/nom/monitor) 

This  CSU  contains  an  assortment  of  shared  routines  and  global  variables.  This  file  contains 
common  routines  used  by  various  monitor  components. 
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2.4.4.1.1  InitMonitorProcess 

This  function  does  initialization  common  to  both  NOM  host  and  SIM  host  monitor 
processes.  This  function  obtains  access  to  the  Ethernet  and  initializes  the  use  of  YUMM. 
Before  opening  a  YUMM  socket,  this  function  deletes  any  left-over  ones  having  the  same 
name,  lliis  function  records  process  ID  in  /tmp/monitorpid. 


1  Parameters  1 

Parameter 

Where  typedef  Declared 

processMessageO 

pointer  to  function  returning 
void 

Standard 

Calls 

Function 

Where  Described 

FatalSystemError 

this  file 

YUMMInit 

libipc  in  MCC  CSCI 

YUMMCleanUo 

libipc  in  MCC  CSCI 

YUMM  Process 

libipc  in  MCC  CSCI 

LkUpSocket 

libipc  in  MCC  CSCI 

CloseSocket 

libipc  in  MCC  CSCI 

OpenSocket 

libipc  in  MCC  CSCI 

RecordProcessID 

Table  2.4-27:  InitMonitorProcess  Information. 

2.4.4. 1.2  FatalSystemError 

This  function  prints  a  system  error  message  in  a  window  and  exits. 

2.4.4. 1.3  ExecuteCommand 
This  function  executes  a  system  command. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

command 

pointer  to  char 

Standard 

Table  2.4-28:  ExecuteCommand  Information. 

2.4.4.1.4  FUNCTION:  int  OpenPseudoTty  (ptyName) 

This  function  finds  and  opens  a  pseudo-tty  for  communication  with  the  monitor  process. 
This  function  then  sets  the  master  pseudo-tty’s  terminal  characteristics. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

PtyName 

pointer  to  char 

Standard 
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1  Cans ^  1 

Function 

Where  Described 

FatalSvstemError 

this  file 

Table  2.4>29:  OpenPseudoTty  Information. 
2.4.4. 1.5  SetTerminalRaw 

This  function  sets  a  terminal's  characteristics  for  raw,  non-blocking  input. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

fd 

int 

Standard 

1  Cails  1 

Function 

Where  Described 

FatalSvstemError 

this  file 

Table  2.4-30:  SetTerminalRaw  Information. 
2.4.4.1.6  FUNCTION:  void  RestoreTerminal  (fd) 

This  function  restores  terminal's  characteristics  to  normal. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

fd 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

FatalSystemEnror 

this  file 

Table  2.4-31:  RestoreTerminal  Information. 


2.4.4. 1.7  SendMonitorResponsePDU 

This  function  sends  a  Monitor  Response  PDU. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

address 

pointer  to  NetworkAddress 

kind 

MonitorKind 

Calls 

Function 

Where  Described 

GET  DATA  PTR 

SendMonitorPDU 

this  file 

Table  2.4-32:  SendMonitorResponsePDU  Information. 
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Parameter 


address 


lenqth 


text 


Where  Typedef  Declared 


inter  to  char 


Standard 


Standard 


Function 


GET  DATA  PTR 


SendMonitorPDU 


Calls 


Where  Described 


this  file 


Table  2.4>33:  SendRemoteConiinandPDU  Information. 

2.4.4.1.9  FUNCTION:  void  SendShellTextPDU  (address,  channel, 
sequenceNumber,  buf,  length) 


This  function  sends  a  Shell  Text  PDU. 


Parameters 


Parameter 


address 


channel 


lenath 


sequenceNumber 


buf 


inter  to  char 


Where  Typedef  Declared 


Standard 


Standard 


Standard 


Standard 


Function 


GET  DATA  PTR 


SendMonitorPDU 


Calls 


Where  Described 


this  file 


Table  2.4-34;  SendShellTextPDU  Information. 

2.4.4.1.10  SendMonitorPDU 

This  function  sends  a  Monitor  PDU  via  /dev/enpl.  The  Ethernet  packet's  header  is  filled  in 
and  the  packet  is  transmitted. 
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1  Calls  1 

Function 

Where  Described 

FatalSystemError 

this  file 

net  addr  bin  to  str 

SET  DSAP 

SET  SSAP 

SET  CONTROL 

SET  PROTOID 

SET  ETHER  TYPE 

Table  2.4>35:  SendMonitorPDU  Information. 

2. 4. 4. 2  circle.c  CSU  Description  (/simnet/cmd/nom/monitor) 

This  CSU  contains  routines  implementing  circular  text  buffers. 

2. 4. 4. 3  circle.h  CSU  Description  (/simnet/cmd/nom/monitor) 

This  CSU  contains  definitions  associated  with  the  routines  in  circle.c. 

2.4.4.4  p_mon.h  CSU  Description  (/simnet/cmd/nom/monitor) 

This  file  defines  the  representation  of  Monitor  Protocol  Data  Units.  These  include  PDUs 
that  query  for  the  presence  of  monitors  on  the  network;  PDUS  for  executing  a  remote 
command;  and  PDUs  for  communicating  with  a  remote  shell. 

This  CSU  is  (derived  from  /simnet/lib/protocol/p_mon.dm)  and  defines  the  monitor 
protocol  used  by  fido  and  rover  to  communicate. 

Rover  and  fido  processes  communicate  via  the  simulation  Ethernet  using  type  code  21001 
(decimal).  The  protocol  used  is  the  "monitor  protocol",  defined  in 
/simnet/lib/protocol/p_mon.dm.  Monitor  PDUs  are  placed  in  Ethernet  packets  with  IEEE 
802.3  headers. 

The  monitor  protocol  provides  a  flow-controlled  text  stream  from  a  shell  running  under  a 
rover  process  to  a  fido  process.  A  positive  acknowledgement  scheme  is  used:  fido  sends 
an  aclmowledgement  to  rover  each  time  text  is  successfully  received.  Character  sequence 
numbers  are  used  to  positions  in  the  text  stream  for  the  purpose  of  acknowledgement.  If 
rover  fails  to  receive  an  acknowledgement  for  text  it  has  sent,  it  will  retry  the  transmission 
at  intervals  up  to  some  maximum  number  of  times. 

Flow  control  and  acknowledgements  are  used  for  text  transmitted  in  one  direction  only: 
from  simulator  to  NOM  system.  Text  from  a  NOM  system  to  a  simulator  is  transmitted 
once  and  once  only. 
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2. 4. 4. 5  monipc.h  CSU  Description  (/simnet/cmd/nom/include) 

This  file  defines  YUMM  messages  communicated  between  a  monitor  process  (fido  or 
rover)  and  its  clients. 

This  CSU  defines  two  forms  of  local  IPC  used  among  processes  making  up  the  monitor 
system; 

-  YUMM  is  used  to  catch  the  attention  of  a  monitor  process  (fido  or  rover) 
and  make  a  request  of  it 

-  pseudo-tty's  are  used  to  pass  text  between  processes 
Uses  of  IPC; 

IPC  is  used  by  mon_wind  is  used  to  spawn  a  remote  shell  and  provide  access  to  it. 

Initially,  fido  is  running  on  a  NOM  host  and  rover  is  running  on  a  simulator  host. 

When  mon_wind  is  invoked  on  the  NOM  host,  it  locates  both  a  free  pseudo-tty  and  the 
YUMM  socket  of  its  local  fido  process.  It  opens  the  pseudo-tty  for  reading  and  writing 
text,  and  sends  a  YUMM  message  to  fido's  socket  that  identifies  that  pseudo-tty  and 
requests  access  to  a  remote  shell  through  it.  Upon  receiving  the  YUMM  message  from 
mon_wind,  fido  sends  a  PDU  to  the  rover  process  running  on  the  simulator  host.  Upon 
receiving  the  PDU,  rover  locates  a  free  pseudo-tty,  forks  a  shell,  and  uses  the  pseudo-tty  to 
read  and  write  stdout,  stderr,  and  stdin  of  the  forked  shell. 

While  the  session  is  open,  mon_wind,  fido,  rover,  and  the  shell  simply  pass  text  among 
each  other  using  pseudo-ttys.  When  the  shell  terminates,  rover  finds  out  by  reading  an 
EOF  on  its  end  of  the  pseudo-tty  shared  with  the  shell.  Rover  sends  a  PDU  to  fido 
notifying  it  that  the  shell  has  quit.  When  fido  receives  this  PDU,  it  closes  its  end  of  the 
pseudo-tty  shared  with  mon_wind.  As  a  result,  mon_wind  reads  an  EOF  on  its  end  of  that 
pseudo-tty  and  it  quits. 

2. 4. 4. 6  monitor.h  CSU  Description  (/simnet/emd/nom/monitor) 

This  CSU  contains  declarations  common  to  NOM  Comms  CSUs.  It  contains  definitions 
shared  among  monitor  components. 


BBN  Systems  and  Technologies 


Network  Operations  and  Maintenance  CSCI 


2.4.5  Start  a  Process  CSC  Description 

This  lower-level  CSC  enables  a  user  at  a  NOM  or  SIM  console  to  start  a  remote  process  at 
the  other  console's  host. 

This  CSC  also  enables  a  user  at  a  SIM  console  to  start  simulation  application  software  from 
a  local  SIM  UNIX  shell.  This  CSC  includes  a  script,  autostart,  which  is  used  to 
automatically  start  the  Ml  simulation  and  tee-in  processes.. 

Functional  breakdown  of  this  lower- level  CSC  is  illustrated  in  Figure  2.4.5- 1. 


Figure  2.4.5-1:  Comms.-Start  SIM  Application. 

2.4.5. 1  mon_lcmd.c  CSU  Description  (/simnet/cmd/nom/monitor) 

This  CSU  can  be  used  on  a  simulator  host  to  cause  a  shell  to  be  spawned  by  its  rover 
process;  it  can  also  be  used  to  pass  a  command  to  a  spawned  shell. 

This  program  executes  a  command  within  a  spawned  shell  on  the  local  system  via  the  local 
rover. 

This  CSU  uses  the  channel  number  of  the  shell  to  be  accessed;  if  that  shell  doesn't  exist,  it 
is  spawned.  This  CSU  passes  an  optional  command  to  the  spawned  shell.  The  command 
may  be  composed  of  multiple  words.  Before  being  passed  to  the  shell  the  words  will  be 
concatenated  with  intervening  blanks  so  that  commands  like,  for  example,  "mon_lcmd  200 
cflO03801  reboot  -h”  will  have  the  desired  effect. 
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2. 4. 5. 1.1  int  main  (argc,argv) 

This  function  is  the  program  entry  point. 

This  function  does  the  following;  checks  comnand  line  arguments,  assembles  a  c(»nmand 
by  concatenating  command  line  arguments,  locates  the  rover  process,  opens  a  free  pseudo- 
tty  for  communicating  with  fido,  sends  the  command  to  rover,  and  closes  the  connection 
with  rover. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

aroc 

int 

Standard 

argv 

pointer  to  array  of  char 

Standard 

Calls 

Function 

Where  Described 

YUMMInit 

fibipc  in  MCC  CSCI 

YUM  M  Process 

ybipcinMCC  CSCI 

LkUpSocket 

ybipc  in  MCC  CSCI 

OpenPseudoTtv 

common.c 

SendMsQ 

ybipc  in  MCC  CSCI 

FatalSystemError 

common.c 

YUMMCleanUp 

ybipc  in  MCC  CSCI 

Table  2.4-36:  main  Information. 

2. 4. 5. 2  mon_rcmd.c  CSU  Description  (/simnet/cmd/nom/monitor) 

This  program  executes  a  command  on  a  remote  system  via  local  and  remote  monitor 
processes. 

This  CSU  can  be  used  on  either  a  NOM  or  a  simulator  host  to  execute  a  program  on  a 
remote  system. 

Mon_rcmd  invokes  a  command  on  a  remote  system  via  local  and  remote  monitor 
processes.  The  local  and  remote  systems  may  each  be  running  either  fido  or  rover.  The 
command  is  invoked  on  the  renwte  system  by  a  system(2)  call.  The  command  may  be 
composed  of  multiple  words.  Before  being  passed  to  the  remote  system  the  words  will  be 
concatenated  with  intervening  blanks  so  that  commands  will  have  the  desired  effect. 

This  CSU  uses  the  simulation  Ethernet  address  of  the  remote  system. 
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2. 4. 5. 2.1  main 

This  function  is  the  program  entry  point. 

This  function  does  the  following:  checks  and  concatenates  command  line  arguments, 
locates  the  local  monitor  process  and  sends  it  a  remote  command  message. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

aroc 

int 

Standard 

arqv 

pointer  to  array  of  char 

Standard 

1  Calls  1 

Function 

Where  Described 

YUMMInit 

ibipcin  MCCCSCI 

YUMMProcess 

ibipcin  MCC  CSCI 

LkUpSocket 

Sbipcin  MCCCSCI 

net  addr  str  to  bin 

SendMsa 

libipc  in  MCC  CSCI 

FatalSystemError 

common. c 

YUMMCleanUo 

libipc  in  MCC  CSCI 

Table  2.4-37: 


main  Information. 


178 


BBN  Systems  and  Technologies _ Network  Operations  and  Maintenance  CSCI 

2.5  NOM'Level  Processes  CSC  Description 

This  CSC  provides  NOM  initialization  procedures  and  interface  definitions  for  use  by  more 
than  one  NOM  top-level  CSC. 

Functional  breakdown  of  NOM-Level  Processes  CSC  is  illustrated  in  Figure  2.5-1. 


Figure  2.5-1; 


NOM-Level  Processes  CSC  Structure. 
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2.5.1  Shared  Interface  Definitions  CSC  Description 

This  lower-level  CSC  contains  protocol  definitions  used  by  several  NOM  CSCs. 

A  functional  breakdown  of  this  lower-level  CSC  into  CSUs  is  shown  in  Figure  2.5. 1-1. 


Shared  IF 
Definitions 

2.5.1 


nomjarots.h 

2.5.1. 1 

mmjsroto.h 

2.5.1. 2 


mm_actions.h 

2.5.1. 3 

mm_events.h 

2.5.1 .4 


sm_states.h 

2.5.1 .5 


pro_start.h 

2.5. 1.6 

basicjype.h 

2.5.1.7 


pro_end.h 

2.5.1. 8 


Figure  2.5.1-1;  NOM  Top-Level  Processes-Shared  Interface  Definitions. 


2.5.1.]  noni_prots.h  CSU  Description  (/simnet/cmd/nom/include) 


This  CSU  defines  protocols  use  by  NOM. 
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2.5. 1.2  inin_proto.h  CSU  Description  (/simnet/cmd/nom/include) 

This  CSU  defines  format  for  Manager-Manager  protocol. 

2.5. 1.3  mm_actions.h  CSU  Description  (/simnet/cihd/nom/include) 

This  CSU  defines  enumerated  values  of  action  IDs,  and  action  response  codes.  Action  IDs 
are  used  for  requesting  operations  to  be  performed  on  managed  resources,  (e.g,  rebooting  a 
simulator)  via  a  mmpActionReqPDU.  Tliese  definitions  conform  to  the  formats  defined  in 
mm_proto.h  (Section  2,5. 1.2). 

2.5. 1.4  mni_events.h  CSU  Description  (/simnet/cmd/nom/include) 

This  CSU  defines  enumerated  values  of  event  IDs.  This  file  contains  registered  event  IDs, 
used  for  rejxnting  errors  and  other  occurrences  recorded  in  an  mmpEventPDU.  These 
definitions  conform  to  the  formats  defined  in  mm_proto.h  (Section  2.5. 1.2). 

2.5. 1.5  sm_states.h  CSU  Description  (/simnet/cmd/nom/include) 

This  CSU  contains  enumerated  values  for  equipment  state  attributes  maintained  by  different 
NOM  processes. 

2.5. 1.6  pro_start.h  CSU  Description  (/simnet/cmd/nom/include) 

This  CSU  contains  definitions  that  precede  includes  of  protocol  header  files.  It  defines 
macros  which  are  used  to  eliminate  naming  conflicts  with  names  chosen  in  protocol  header 
files. 


2.5. 1.7  basic_type.h  CSU  Description  (/simnet/cmd/nom/include) 

This  CSU  defines  commonly-used  basic  types  and  extensions. 

2.5. 1.8  pro_end.h  CSU  Description  (/simnet/cmd/nom/include) 

This  CSU  contains  definitions  that  follow  includes  of  protocol  header  files.  It  undefines 
macros  which  are  used  to  eliminate  naming  conficts  with  names  chosen  in  protocol  header 
files. 

2.5.2  Initialize  NOM  Processes  CSC  Description 

This  lower-level  CSC  contains  scripts  for  starting/stopping  NOM  processes. 

A  functional  breakdown  of  this  lower-level  CSC  into  CSUs  is  shown  in  Figure  2.5.2- 1. 
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Init  NO&M 
Processes 

2.5.2 


start_nom 

2.5.2.1 

kill_rx>m 
2.5.2  2 

autostart 

2.52.3 

mon_kill.c 

2.5.2.4 


Figure  2.5.2-1:  NOM  Top-Level  Processes— Initialize  NOM  Processes. 


2.5.2. 1  start  nom  CSU  Description  (/simnet/cmd/nom/scripts) 

NOM  is  started  by  the  script  nom/script/start_nom.  This  script  runs 
nom/bin/nom_netstart,  which  loads  nom_enp.bin  into  the  CMC  card,  and  then  starts  the 
NOM  processes,  gui,  mini  (MAP),  lamp,  and  monitors  NOM  host  program  entry  point. 

2.5.2.2  kill_nom  CSU  Description  (simnet/cmd/nom/scripts) 

This  CSU  is  used  to  kill  all  previous  NOM  processes  and  clean  up  the  state  of  NOM  before 
it  is  restarted. 

2. 5. 2. 3  autostart  CSU  Description  (simnet/cmd/nom/scripts) 

This  CSU  resides  on  actual  simulators.  It  is  used  to  automatically  start  monitor  processes 
on  a  simulator. 

2. 5. 2. 4  nom_netstart.c  CSU  Description  (simnet/cmd/nom/monitor) 

This  CSU  loads  the  CMC  card  with  a  NOM-specific  filter  at  startup  time. 
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2.5.3  NOM  Libraries  CSC  Description 

This  lower-level  CSC  contains  libraries  whose  functions  are  called  by  NOM  CSCs.  These 
libraries  are  SIMNET-wide. 

A  functional  breakdown  of  this  lower-level  CSC  into  CSUs  is  shown  in  Figure  2.5.3-1. 


NO&M 

Libraries 


iibassoc.a 

2.5.3.1 

libcomm.a 

2.5.3.2 

libdev.a 

2.53.3 


libevent.a 

2.5.3.4 


libmov.a 

2.5.3.9 

libnetif.a 

2.5.3.10 

libpdu.a 

2.5.3.11 

Mbshm.a 

2.5.3.12 


libmath.a 

2.53.5 


libipc.a 

2.5.3.6 


libterrain.a 

2.5.3.13 

libtty.a 

2.5.3.14 


libmem.a 

2.53.7 


libmisc.a 

2.5.3.8 


libutil.a 

2.5.3.15 

^attlib/libcOOOO.a 

2.5.3.16 
libtdb.a 
2.5.3.17 


Figure  2.5.3-1:  NOM  Top-Level  Processes-NOM  Libraries. 
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2.5.3. 1  libassoc 

This  CSU  is  a  SIMNET  system  library.  It  provides  functions  for  the  association  layer  of 
the  SIMNET  protocols.  This  library  is  documented  in  Section  2.20.1  of  the  MCC  CSCI 
document. 

2. 5. 3. 2  libcomm  (/simnet/lib) 

This  CSU  is  a  SIMNET  system  library. 

2. 5. 3. 3  libdev  CSU  Description  (/simnet/lib) 

This  CSU  is  a  SIMNET  system  library. 

2. 5. 3. 4  libevent  CSU  Description  (/simnet/lib) 

This  CSU  is  a  SIMNET  system  library  documented  under  the  Vehicles  CSCI. 

2. 5. 3. 5  libmath  CSU  Description  (/simnet/lib) 

This  CSU  is  a  SIMNET  system  library  documented  under  the  Vehicles  CSCI 

2. 5. 3. 6  libipc  CSU  Description  (/simnet/lib) 

This  CSU  is  a  SIMNET  system  library  documented  under  the  MCC  CSCI.  It  contains  the 
YUMM  library  whose  functions  are  used  by  NOM  for  IPC  message-passing. 

2. 5. 3. 7  libmem  CSU  Description  (/simnet/lib) 

This  CSU  is  a  SIMNET  system  library  documented  under  the  Vehicles  CSCI. 

2.5. 3.8  libmisc  CSU  Description  (/simnet/lib) 

This  CSU  is  a  SIMNET  system  library. 

2. 5. 3. 9  libmove  CSU  Description  (/simnet/lib) 

This  CSU  is  a  SIMNET  system  library  documented  under  the  Vehicles  CSCI. 

2.5.3.10  libnetif  CSU  Description  (/simnet/lib) 

This  CSU  is  a  SIMNET  system  library  documented  under  the  MCC  CSCI. 

2.5.3.11  libpdu  CSU  Description  (/simnet/lib) 

This  CSU  is  a  SIMNET  system  library.  It  is  used  by  NOM  for  defining  and  passing 
PDUs. 

2.5.3.12  libshm  CSU  Description  (/simnet/lib) 

This  CSU  is  a  SIMNET  system  library  documented  under  the  Vehicles  CSCI.  It  is  used  by 
NOM  for  shared  memory  access. 
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2.5.3.13  libterrain  CSU  Description  (/simnet/lib) 

This  CSU  is  a  SIMNET  system  library. 

2.5.3.14  libtty  CSU  Description  (/simnet/lib) 

This  CSU  is  a  SIMNET  system  library. 

2.5.3.15  libutil  CSU  Description  (/simnet/lib) 

This  CSU  is  a  SIMNET  system  library  documented  under  the  Vehicles  CSCI. 

2.5.3.16  /attlib/libcOOOO.a 

This  CSU  is  a  standard  "C"  library.  It  is  used  for  graphics  applications. 

2.5.3.17  libtdb 

This  CSU  is  a  SIMNET  system  library  containing  terrain  database  functions  documented 
under  the  MCC  CSCI. 
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APPENDIX  A:  TYPE  NAMES  AND  WHERE  THEY  ARE  DEFINED 


Type  Names 


Where  DeHned 


ScreenClassRec; 

screens.h 

ActionRsp; 

mm_actions.h 

AttachMessage; 

monipc.h 

CircleBuffer, 

circle.h 

ErrorCode; 

global. h 

Event; 

events.h 

f_text 

text.h 

FieldRec; 

screens.h 

ListRequestMessage; 

monipc.h 

MMP  PDUData; 

mm_proto.h 

MMP_PDUStruct; 

mm_proto.h 

NomEquipInfo; 

nom_shmem.h 

Nominfo; 

nom_shniem.h 

pr  size 

xglobals.’ . 

PR_SIZE; 

xglobals.h 

RemoteCommandMessage; 

monipc.h 

ScreenRec; 

screens.h 

ScreenWidget; 

screens.h 

ScreenWidgetClass; 

screens.h 

SP_Monitor_PDU ; 

p_mon.h 

SP_Monitor_PDUKind; 

p_mon.h 

SP_MonitorKind; 

SP_MonitorProtocol 

p_mon.h 

Version; 

SP_MonitorResponse 

p_mon.h 

Variant; 

S  P_RemoteCommand 

p_mon.h 

Variant; 

p_mon.h 

SP_ShellAckVariant; 

p_mon.h 

SP_ShellOpenVariant; 

p_mon.h 

SP_ShellStatus; 

p_mon.h 

SP_ShellStatusVariant; 

p_mon.h 

SP_ShellTextV  ariant; 

p_mon.h 

switch_struct 

panel.h 

WriteMessage; 

monipc.h 
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APPENDIX  B:  MACRO  FUNCTION  NAMES  AND 
WHERE  THEY  ARE  DEFINED 


Macro  Function  Names 


Where  Defined 


char_advance(font,char) 

char_height(font) 

char_width(font) 

CircleBufferAmount(buO 

CircleBufferAvail(buf) 

CircleB  ufferClear(  buO 

CircleBufferEmpty(buO 

FillInNetHdr(b,  a) 

ICON_NAME_X(i) 

ICON_NAME_Y(i) 

ICON_STATE_X(i) 

ICON_STATE_Y(i) 

NetTableEntry(n) 

NetTableUnlock(n) 


fonts.h: 

fonts.h: 

fonts.h: 

circle.h: 

circle.h: 

circle.h; 

circle.h: 

MCC_net.h: 

icons.c 

icons.c 

icons.c 

icons.c 

MCC_net.h: 

MCC_net.h: 
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INDEX  BY  SECTION  NUMBER 


/attlib/libcOOOO.a 

act_ActionReqPDUFill 

act_Sen(iActionToSelected 

act_SendAndCheckReq 

actions.c  CSU  Description  (/simnet/ctnd/nom/gui) 

actions.h  CSU  Description  (/simnet/cmd/nom/gui) 

activate.c  CSU  Description  (/simnet/cmd/nom/gui) 

activate.h  CSU  Description  (/simnet/cmd/nom/gui) 

activate_C!ancelTest 

activate_ConfirmParam 

activate_ConrirmTest 

activate_DisplayParams 

activate_DisplayT  est 

activate_Init 

activate_Setup 

activateCancelParam 

add_ether 

add_lampName 

attach_nom._table 

AttachToQiannel 

autostart  CSU  Description  (simnet/cmd/nom/scripts) 
Auxiliary  Window  Handling  CSC  Description 
basic_type.h  CSU  Description  (/simnet/cmd/nom/include) 
blink 

blink.c  CSU  Description  (/simnet/cmd/nom/gui) 
blink_msg 

canvas.c  CSU  Description  (/simnet/cmd/nom/gui) 

canvas.h  CSU  Description  (/simnet/cmd/nom/gui) 

canvas_Clear 

canvas_ClearCallbacks 

canvas_Exposed 

canvas_InitCanvas 

canvas_Left 

canvas_Redisplay 

canvas_Revert 

canvas_Selected 

canvas_SetupCanvas 

(ZatchCLDSignal 

char.c  CSU  Description  (/simnet/cmd/nom/gui) 
char.h  CSU  Description  (/simnet/cmd/nom/gui) 
char_handler 


2.5.3.16 

2.1.5. 3.1 

2.1.5.3.2 

2.1.5.3.3 

2.1.5.3 

2.1.5.7 
2.1.1.10 
2.1.1.24 

2.1.1.10.7 

2.1.1.10.5 

2.1.1.10.8 

2.1.1.10.4 

2.1.1.10.3 
2.1.1.10.1 
2.1.1.10.2 

2.1.1.10.6 

2.3.1.1.12 

2.3.2.1.2 

2.3.2.1.1 

2.4.3.1.3 

2.5.2.3 

2.1.4 

2. 5. 1.7 

2.1.2.20.3 
2.1.2.20 
2.1.5.2.5 
2.1.2.9 

2.1.2.1 

2.1.2.9.4 

2.1.2.9.2 

2.1.2.9.7 
2.1.2.9.1 

2.1.2.9.7 

2.1.2.9.5 

2.1.2.9.6 

2.1.2.9.8 

2.1.2.9.3 

2.4.2.1.4 

2.1.2.12 

2.1.2.4 

2.1.2.12.6 
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circle.c  CSU  Description  (/simnet/cmd/nom/monitor) 

2.4.4.2 

circle.h  CSU  Description  (/simnet/cmd/nom/monitor) 

2.4.4.3 

clear_message 

2.1.5.2.4 

CloseConnection 

2.4.1. 1.7 

color_InitColors 

2.1.7. 5.1 

colors.c  CSU  Description  (/simnet/cmd/nom/gui) 

2.1.7.5 

colors.h  CSU  Description  (/simnet/cmd/nom/gui) 

2.1.7.9 

common.c  CSU  Description  (/simnet/cmd/nom/monitor) 

2.4.4. 1 

Constrain  tlnidalize 

2.1. 1.8. 2 

cursor.c  CSU  Description  (/simnei/cmd/nom/gui) 

2.1.2.13 

cursor.h  CSU  Description  (/simnet/cmd/nom/gui) 

2.1.2.5 

do_init 

2.2.8.5.1 

do_ioctl 

2.2.8.5.2 

do_packet_from_host 

2.2.8.5.4 

do_packet_from_network 

2.2.8.5.5 

do_tick 

2.2.8.5.3 

draw_char_string 

2.1.2.12.5 

draw_cursor 

2.1.2.12.1 

draw_GetWidth 

2.1. 1.2.1 

draw_InitMenu 

2. 1.1. 2. 2 

draw_menu.c  CSU  Description  (/simnet/cmd/nom/gui) 

2.1. 1.2 

draw_menu.h  CSU  Description  (/simnet/cmd/nom/gui) 

2.1.1.16 

draw_Select 

2.1. 1.2.4 

tiraw_SetupMenu 

2.1. 1.2.3 

Drawing  Area  Input  Handling  CSC  Description 

2.1.2 

Drawing  Area  Status  Display  CSC  Description 

2.1.3 

EM_QeanUp 

2.2.4.1.11 

EM_EventGetText 

2.2.4. 1.4 

EM_EventIsActFail 

2.2.4.1.2 

EM_EventIsActFail 

2.2.4.1.3 

EM.EventPDUFill 

2.2.4.1.6 

EM_EventReceive 

2.2.4.1.5 

EM_iCopySubscriptions 

2.2.4.1.13 

EM_iEventGetIndex 

2.2.4.1.14 

EMJGetTimeField 

2.2.4.1.12 

EM_InitEM 

2.2.4.1.1 

EM_LogEventText 

2.2.4.1.10 

EM_SendNewStateEvent 

2.2.4.1.7 

EM_SubscriptionReceive 

2.2.4. 1.9 

Equip_ClearEvents 

2.2.1.1.16 

Equip_EquipmentReceived 

2.2.1.1.20 

Equip_EquipmentStatus 

2.2.1.1.21 

Equip_ErrorReceived 

2.2.1.1.15 
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Equip_EventStatus 

2.2.1.1.17 

• 

Equip_ExerciseStatus 

2.2.1.1.23 

equip_GetFirstSelected 

2.1.3.2.5 

equip_GetNumSelected 

.  2.1.3.2.4 

Equip_GetTrailerLoc 

2.2.1. 1.1 

Equip_lntialize 

2.2.1.1.18 

Equip_LogEvent 

2.2.1. 1.2 

Equip_ProcessEvent 

2.2.1. 1.3 

equip_ReflectEquipS  tate 

2.1. 3. 2.3 

Equip_Shutdown 

2.2.1.1.24 

equip_StringMatchesTrailer 

2.1.3.2.2 

equip_TrailerToIndex 

2.1.3.2.1 

Equip_UpdateState 

2.2.1.1.19 

Equip_VehicleStatusReceived 

2.2.1.1.22 

equipments  CSU  Description  (/simnet/cmd/nom/gui) 

2.1. 3.2 

equipmenLc  CSU  Description  (/simnet/cmd/nom/mini) 

2. 2.1.1 

equipment.h  CSU  Description  (/simnet/cmd/nom/gui) 

2.1.5.9 

EquipmentDoMonitor 

2.2.1.1.28 

Equipmendnitialize 

2.2.1.1.27 

EquipmentInitTerrain 

2.2.1.1.26 

EquipmentParseFile 

2.2.1.1.25 

A 

EquipmentPowerdown 

2.2.1.1.31 

w 

EquipmentRetryPowerdown 

2.2.1.1.30 

erase_char_string 

2.1.2.12.4 

Event_AddEvent 

2. 2.1. 1.4 

event_EventDispatch 

2.1.3.1.2 

event_EventDisplay 

2.1. 3. 1.1 

events.c  CSU  Description  (/simnet/cmd/nom/gui) 

2. 1.3.1 

events.c  CSU  Description  (/simnet/cmd/nom/mini) 

2.2.4.1 

events.h  CSU  Description  (/simnet/cmd/nom/gui) 

2.1.5.8 

events.h  CSU  Description  (/simnet/cmd/nom/mini) 

2.2.4.2 

exec.c  CSU  Description  (/simnet/cmd/nom/gui) 

2.1.4.1 

exec.h  CSU  Description  (/simnet/cmd/nom/gui) 

2.1.4.2 

exec_CloseAuxiliaryWindow 

2.1.4.1.3 

exec_Ctommand 

2.1.4.1.1 

exec_OpenAuxiliaryWindow 

2.1.4.1.2 

exec_RemoteTerminal 

2.1.4.1.4 

exec_ViewFiIe 

2.1.4.1.5 

ExecuteCommand 

2.4.4.1.3 

FatalSystemError 

2.4.4.1.2 

fido.c  CSU  Description  (/simnet/cmd/nom/monitor) 

2.4. 1.1 

file.c  CSU  Description  (/simnet/cmd/nom/gui) 

2.1.2.10 

• 

file.h  CSU  Description  (/simnet/cmd/nom/gui) 

2.1.2.2 
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file_LoadDefaultFile  . 

2.1.2.10.1 

file_LoadFile 

2.1.2.10.2 

file_WriteCurrentFile 

2.1.2.10.3 

find_shmem_index 

2.3.2.1.15 

fontJnitFonts 

2.1.7.4.1 

fonts.c  CSU  Description  (/simnet/cmd/nom/gui) 

2.1.7.4 

fonts.h  CSU  Description  (/simnet/cmd/nom/gui) 

2.1.7. 8 

OpenPseudoTty 

2.4.4.1.4 

CloseShell 

2.4.2.1.9 

ProcessMessage 

2.4.2.1.11 

RestoreTerminal 

2.4.4.1.6 

SendSheUTextPDU 

2.4.4.1.9 

get_emstate 

2.3.2.1.14 

get_grid 

2.1.1.9.13 

get_lamp_addr 

2. 3.2. 1.5 

get_lamp_dev 

2.3.2. 1.3 

get_lamp_timeout() 

2.3.2.1.6 

get_numEquip 

2.3.2.1.4 

get_powerstate 

2.3.2.1.8 

get_readystate 

2.3.2.1.10 

get_smokestate 

2.3.2.1.12 

global.c  CSU  Description  (/simnet/cmd/nom/gui) 

2.1.7.2 

global.h  CSU  Description  (/simnet/cmd/nom/gui) 

2.1.7.6 

globals.c  CSU  Description  (/simnet/cmd/nom/mini) 

2.2.3.2 

globals.h  CSU  Description  (/simnet/cmd/nom/mini) 

2.2.3.3 

GlobalsCleanUp 

2.2. 3. 2. 2 

Globalsinitialize 

2.2.3.2.1 

Graphical  User  Interface  (GUI)  CSC  Description 

2.1 

grid.c  CSU  Description  (/simnet/cmd/nom/gui) 

2.1.2.14 

grid.h  CSU  Description  (/simnet/cmd/nom/gui) 

2.1.2.6 

grid_SetValue 

2.1.2.14.2 

grid_Toggle 

2.1.2.14.3 

guijpc.c  CSU  Description  (simnet  /cmd/nom/gui) 

2.1.5.1 

guijpc.h  CSU  Description  (/simnet/cmd/nom/gui) 

2.1.5.5 

icon_AddIconFromDesc 

2.1.2.15.16 

icon_AddIconToList 

2.1.2.15.10 

icon_AllIconsToFile 

2.1.2.15.15 

icon_Blink 

2.1.2.15.30 

icon_CreateIcon 

2.1.2.15.33 

icon_Delete 

2.1.2.15.27 

icon_DeleteAll 

2.1.2.15.17 

icon_DeleteSelected 

2.1.2.15.18 

icon_Draw 

2.1.2.15.9 
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icon_Drop 

2.1.2.15.19 

icon_DropOn 

2.1.2.15.6 

icon_Erase 

2.1.2.15.34 

icon_GetEquip 

2.1.2.15.5 

icon_GetHonestX 

2.1.2.15.28 

icon_GetHonestY 

2.1.2.15.29 

icon_GetNextSelIcon 

2.1.2.15.3 

icon_InitIcons 

2.1.2.15.1 

iconJsSelected 

2.1.2.15.4 

icon_LocToIcon 

2.1.2.15.31 

icon_MoveDone 

2.1.2.15.26 

icon_MoveStart 

2.1.2.15.25 

icon_NameAbort 

2.1.2.15.24 

icon_NameDone 

2.1.2.15.23 

icon_NameC)n 

2.1.2.15.8 

icon_NameStart 

2.1.2.15.22 

icon_RedisplayAll 

2.1.2.15.11 

icon_Select 

2.1.2.15.20 

icon_SelectAll 

2.1.2.15.13 

icon_SelectOn 

2.1.2.15.7 

icon_SetupIcons 

2.1.2.15.2 

icon_TagToIcon 

2.1.2.15.32 

icon_Toggle 

2.1.2.15.21 

icon_WriteIconsToFile 

2.1.2.15.14 

icons.c  CSU  Description  (/simnet/cmd/nom/gui) 

2.1.2.15 

icons.h  CSU  Description  (/simnet/cmd/nom/gui) 

2.1.2.7 

Important  Events  CSC  Description 

2.2.4 

init_grid 

2.1.2.14. 

init_lampnet 

2.3. 1.1. 3 

init_msg 

2.1.5.2.1 

init_switch 

2.1.1.9.12 

Initialize 

2.1. 1.8.1 

Initialize  NOM  Processes  CSC  Description 

2.5.2 

initialize_char_handler 

2.1.2.12.2 

InitMonitorProcess 

2.4.4.1.1 

int  main 

2.4.5.1.1 

Interface  to  Comms.  CSC  Description 

2.2.5 

Interface  to  Comms.CSC  Description 

2.1.6 

Interface  to  GUI  CSC  Description 

2.2.7 

Interface  to  Lamplighter-int  CSC  Description 

2.2.6 

Interface  to  MAP  CSC  Description 

2.1.5 

Interface  to  MAP  CSC  Description 

2.3.2 

Interface  to  SIMNET  Network  CSC  Description 

2.2.8 
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IPC.CleanUp 

2.1.5. 1.8 

IPC_InitIPC 

2.1.5.1.1 

IPC.InitIPC 

2.2.7. 1.1 

ipc_process 

2.3.1. 1.5 

IPC_ProcessMessage 

2.1.5.1.3 

IPC_ProcessMessage 

2.2.7. 1.2 

IPC_SendMessage 

2.1.5. 1.5 

IPC_SendMessage 

2.2.7. 1.4 

IPC_SendRequest 

2.1.5.1.6 

IPC_SetupIPC 

2.1.5.1.2 

IPC_TraceMessage 

2.1.5.1.4 

IPC_TraceMessage 

2.2.7. 1.3 

IPC_Transact 

2.1.5. 1.7 

itoa 

2.3.1.1.14 

kill_nom  CSU  Description  (simnet/cmd/nom/scripts) 

2.5.2.2 

lamp_int.c  CSU  Description  (/simnet/cmd/nom/lamp) 

2.3.1. 1 

Lamplighter  Interface  CSC  Description 

2.3 

Lamplighter  Interface  Processing  CSC  Description 

2.3.1 

libassoc 

2.5.3. 1 

libcomm  (/simnet/lib) 

2.5.3.2 

libdev  CSU  Description  (/simnet/lib) 

2.5.3.3 

libevent  CSU  Description  (/simnet/lib) 

2.5.3.4 

libipc  CSU  Description  (/simnet/lib) 

2.5.3.6 

libmath  CSU  Description  (/simnet/lib) 

2.5.3.5 

libmem  CSU  Description  (/simnet/lib) 

1.53.1 

libmisc  CSU  Description  (/simnet/lib) 

2.5. 3. 8 

libmove  CSU  Description  (/simnet/lib) 

2.5.3.9 

libnetif  CSU  Description  (/simnet/lib) 

2.5.3.10 

libpdu  CSU  Description  (/simnet/lib) 

2.5.3.11 

libshm  CSU  Description  (/simnet/lib) 

2.5.3.12 

libtdb 

2.5.3.17 

libterrain  CSU  Description  (/simnet/lib) 

2.5.3.13 

libtty  CSU  Description  (/simnet/lib) 

2.5.3.14 

libutil  CSU  Description  (/simnet/lib) 

2.5.3.15 

ListConnections 

2.4.3. 1.2 

LookupConnection 

2.4.1. 1.8 

LookupMachineByAddress 

2.4.1.1.12 

LookupShellByChannel 

2.4.2.1.10 

main 

2.1.6.1.1 

main 

2.1.7. 1 

main 

2.2.3. 1.1 

main 

2.3.1. 1.1 

main 

2.4.1. 1,1 
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main 

2.4.2.1.1 

main 

2.4.3.1.1 

main 

2.4.5.2.1 

main.c  CSU  Description  (/simnet/cmd/nom/gui) 

2.1.7. 1 

main.c  CSU  Description  (/simnet/cmd/nom/mini) 

2.2.3. 1 

mainjoop 

2.3.1. 1.2 

MainLoop 

2.1.7.1.4 

Manage  Simulations  CSC  Description 

2.2.2 

Manage  Simulators  CSC  Description 

2.2.1 

MAP  (Management  Applications  Process)  CSC  Description 

2.2 

Menu  Handling  CSC  Description 

2.1.1 

mini_ipc.c  CSU  Description  (/simnet/cmd/nom/mini) 

2.2.7. 1 

misc_InitMenu 

2.1. 1.6.1 
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